dotfiles

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

dotfiles managed with chezmoi.

What's in here

File	Purpose
.zshrc	Main zsh config — plugins, aliases, tool integrations
.zprofile	Login shell config — PATH setup
.gitconfig	Git identity and credential settings
~/.config/starship.toml	Starship prompt appearance and modules
~/.config/zsh/starship.zsh	OS/distro icon detection for the prompt
~/.config/thefuck/settings.py + rules/	Custom thefuck command-correction rules
iTerm2 preferences	Terminal app settings, profiles, and appearance

Tools this setup depends on

• 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

Setting up on a new machine

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.

Maintaining this setup

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

Notes

• 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.