Dotfiles

Managed with chezmoi, these dotfiles keep shell, editor, and CLI configuration synchronized across machines. Files prefixed with dot_ map directly to paths in $HOME (for example dot_zshenv → ~/.zshenv).

Tooling Overview

Tool	Role
chezmoi	Apply and template the repository contents.
mise	Install pinned runtimes and development tools.
Homebrew	Provision CLI tools and apps.
Warp	Terminal profile stored in dot_warp/.
Docker	CLI settings in dot_docker/.
Prettier	Formatter defaults from dot_prettierrc.

Executable helpers live in bin/. Archived or inactive configs reside in archive/.

Setup

1. Install prerequisites

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   brew install chezmoi jdx/mise/mise

2. Apply the dotfiles

   chezmoi init --apply <github-username>/dotfiles

3. Install toolchains

   mise install

   Run brew bundle if a Brewfile is present.

Common chezmoi Commands

• Edit and apply a file in one step: chezmoi edit --apply <path>
• Review pending changes: chezmoi diff
• Re-apply everything: chezmoi apply
• Adjust attributes (e.g., remove private flag): chezmoi chattr -- -p <path>

Repository Layout

• dot_* files map to configuration files in $HOME.
• bin/ contains executables linked into ~/bin.
• archive/ holds legacy configuration kept for reference.
• install/ contains idempotent installation scripts.
• scripts/ contains the bootstrap script and shared library functions.
• tests/ contains basic smoke tests to validate scripts.

Testing

Basic smoke tests ensure installation scripts are valid:

# Install test dependencies
brew install bats-core shellcheck

# Run smoke tests
bats tests/smoke.bats

# Lint scripts
shellcheck install/*.sh scripts/**/*.sh

Bootstrap Script

For a fresh machine setup, use the bootstrap script:

# Clone the repository
git clone https://github.com/<username>/dotfiles.git ~/.local/share/chezmoi
cd ~/.local/share/chezmoi

# Run bootstrap (installs Homebrew, mise, chezmoi, and applies dotfiles)
./scripts/bootstrap.sh

# With options
./scripts/bootstrap.sh --help
./scripts/bootstrap.sh --debug

The bootstrap script will:

1. Install Homebrew (if not present)
2. Install mise for runtime management
3. Install and configure chezmoi
4. Apply dotfiles from this repository
5. Install packages from Brewfile (if present)