My dotfiles

My personal macOS configuration, managed with chezmoi.

What's managed

• Shell: fish with vi key bindings, a minimal no-background oh-my-posh prompt, and a macfetch system summary at login
• Terminal: Ghostty (Alt+V for a Vim-style scrollback key table), with zellij as the multiplexer inside it
• Editors: LazyVim, Zed, VS Code settings and extensions
• CLI: git, gh, gh-dash, btop, k9s, atuin, carapace, television (tv), zoxide, ripgrep, bat, macfetch
• AI tools: Claude, Codex, Oh My Pi
• macOS: .wakeup, .sleep, selected app preferences, and safe defaults
• Packages and apps: Brewfile

Most managed configuration files are symlinks into home/config-src/. Edit either the live file (for example ~/.config/fish/config.fish) or its source file; the change is live immediately.

~/.config/nvim is different: chezmoi clones LazyVim/starter there as its own Git repository. Customize and commit it from that directory.

Layout

Brewfile                 Homebrew formulae, casks, and fonts
scripts/                 Manual maintenance scripts
home/
  .chezmoiscripts/       Ordered one-time setup hooks
  .chezmoiexternal.yaml  LazyVim Git clone definition
  .chezmoidata.yaml       Personal, non-secret template settings
  config-src/            Actual configuration files

Personal settings

home/.chezmoidata.yaml is the commented catalog for personal and machine-specific, non-secret values: identity, GitHub, Git, shell, editors, terminal, Homebrew, macOS, CLI tools, languages, AI tools, and common paths.

zed "$HOME/development/dotfiles/home/.chezmoidata.yaml"
chezmoi apply ~/.gitconfig

Git name and email are rendered into ~/.gitconfig. Its GitHub username and protocol are derived from config-src/cli/gh/hosts.yml, the config maintained by gh auth login. Never store tokens, passwords, API keys, or private keys in this repository.

For a path inside a template, use {{ .chezmoi.homeDir }} or a value from .chezmoidata.yaml; never hardcode /Users/<name>. The Codex configuration uses this pattern and is rendered by chezmoi rather than symlinked.

Setup

# Install chezmoi, then point it at this local checkout.
brew install chezmoi
chezmoi init --source "$HOME/development/dotfiles"

# Preview all changes first.
chezmoi diff

# Apply only files and symlinks. No package installs or macOS changes.
chezmoi apply --exclude=scripts

# Apply the complete machine setup, including the Brewfile and one-time hooks.
chezmoi apply

The full apply installs Homebrew packages, syncs LazyVim plugins, installs VS Code extensions, enables the sleepwatcher service, and applies safe macOS defaults.

Daily commands

# See pending changes.
chezmoi status
chezmoi diff

# Apply configuration changes.
chezmoi apply --exclude=scripts

# Apply everything, including one-time setup scripts.
chezmoi apply

# Commit this repository.
cd "$HOME/development/dotfiles"
git add -A
git commit -m "describe the change"

Checks

# A blank result with exit code 0 means the target matches chezmoi.
chezmoi verify

# Exit code 1 with no output means something is pending; identify it here.
chezmoi status

# Shell and prompt.
fish -n ~/.config/fish/config.fish
fish -c 'type oh-my-posh'
oh-my-posh print primary --config ~/.config/oh-my-posh/config.yaml

# Editors.
zed .
git -C ~/.config/nvim remote get-url origin
nvim --headless "+Lazy! sync" +qa

# Managed CLI configuration.
k9s info
git lg -3

# Terminal multiplexer.
zellij setup --check

Manual actions

# Enable Touch ID for sudo. Requires an administrator password.
scripts/macos-touch-id-sudo.sh

# Make fish the default login shell. Requires sudo and the account password.
scripts/set-default-shell-fish.sh

# Save or restore Raycast, Shottr, Amphetamine, boringNotch, and IINA preferences.
scripts/backup-gui-prefs.sh
scripts/restore-gui-prefs.sh

Brave, Zen, WhatsApp, Beekeeper Studio, Obsidian, and Supacode are installed through the Brewfile, but their machine-specific application databases are not managed here.