My portable terminal environment for macOS, built around zsh, Starship, and iTerm2.

dotfiles managed with chezmoi.

• Homebrew ➞ Package manager
• chezmoi ➞ dotfile manager
• zsh ➞ Shell
• iTerm2 ➞ Terminal emulator
• Starship ➞ Prompt
• zsh-autocomplete ➞ Tab-completion plugin
• zsh-autosuggestions ➞ Inline command suggestions
• zsh-syntax-highlighting ➞ Colors commands as you type
• autojump ➞ Fast directory jumping
• eza ➞ Modern ls replacement
• thefuck ➞ Command-correction tool

1. Install Homebrew:

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

2. Install chezmoi and initialize from this repo:

   brew install chezmoi
   chezmoi init --apply git@github.com:avocadoattack/dotfiles.git
   

3. Install the tools listed above via Homebrew and their respective zsh plugins.

4. Restart your terminal. chezmoi apply will have already placed all config files in the right spots.

Editing a tracked text file (e.g. .zshrc):

cd ~/.local/share/chezmoi
chezmoi edit ~/.zshrc
chezmoi diff
chezmoi apply
git status              # confirm the real source filename before staging
git add <file>
git commit -m "description"
git push

Editing a GUI-configured file (e.g. iTerm2 preferences):

# make the change in the app itself, then:
cd ~/.local/share/chezmoi
chezmoi re-add
chezmoi diff
git status              # confirm the real source filename before staging
git add <file>
git commit -m "description"
git push

• Some files use chezmoi's templating ({{ .chezmoi.homeDir }}) so paths resolve correctly regardless of the machine's username.
• Source filenames often differ from live filenames due to chezmoi's naming convention (e.g., .zshrc → dot_zshrc.tmpl, and files under .chezmoiignore-adjacent private paths get a private_ prefix). Run git status or chezmoi source-path <live-file> if git add can't find the file you expect.
• SSH keys, GPG keys, shell history, and credential files were never added to this repo — see .chezmoiignore for the full list and reasoning.