Dotfiles

macOS dotfiles: Zsh, Homebrew, Kitty, pyenv, and dev tools.

Prerequisites

• macOS
• Xcode Command Line Tools (xcode-select --install)

Quick Start

git clone <your-repo-url> ~/.dotfiles
cd ~/.dotfiles
./setup.sh

Restart your terminal when done.

Updating Symlinks Only

After pulling changes to config files, re-link without re-running the full setup:

./setup.sh --link

This only refreshes symlinks for home dotfiles, config directories, CLAUDE.md, gh config, and the wt command. Skips Homebrew, fonts, Oh My Zsh, pyenv, git config prompts, and everything else.

What the Script Does

1. Installs Homebrew if missing
2. Installs brew formulae: eza, gh, git-lfs, node, bun, pyenv, tmux, tree, uv (plus pyenv build deps: openssl, readline, sqlite3, xz, zlib)
3. Installs brew casks: kitty, font-hack-nerd-font
4. Installs herdr via the official herdr.dev installer — not Homebrew, so herdr update and its live handoff keep working
5. Installs IBM Plex Mono font from GitHub
6. Installs Oh My Zsh with Powerlevel10k, zsh-autosuggestions, and zsh-syntax-highlighting (pinned versions)
7. Symlinks home dotfiles (.zshrc, .zprofile, .p10k.zsh, .vimrc)
8. Generates .gitconfig from template (prompts for name and email)
9. Symlinks config directories (kitty, git), the global ~/.claude/CLAUDE.md, and copies gh config
10. Installs wt worktree helper to ~/.local/bin
11. Installs Python 3.13.3 via pyenv
12. Sets up Git LFS
13. Optionally installs Google Cloud SDK

Existing files are backed up with timestamps (e.g. ~/.zshrc.backup.20240101_120000) before being replaced.

Directory Structure

dotfiles/
├── bin/
│   └── wt                    # Git worktree helper
├── claude/
│   └── CLAUDE.md             # Global Claude Code instructions -> ~/.claude/CLAUDE.md
├── config/
│   ├── gh/                   # GitHub CLI config (copied, not symlinked)
│   ├── git/                  # Git global ignore
│   └── kitty/                # Kitty terminal theme and config
├── home/
│   ├── .gitconfig.template   # Git config with placeholder name/email
│   ├── .p10k.zsh             # Powerlevel10k prompt config
│   ├── .vimrc                # Vim config
│   ├── .zprofile             # Login shell setup (Homebrew, pyenv, PATH)
│   └── .zshrc                # Interactive shell config (Oh My Zsh, plugins)
├── setup.sh
└── README.md

Post-Install

• Run p10k configure to reconfigure the prompt
• Set Kitty (or your terminal) font to Hack Nerd Font for proper icons
• The wt command is available after restart -- run wt --help for usage