Dotfiles 🌚

Personal dotfiles and development environment for macOS, managed by chezmoi.

Quick start

1. Install Xcode Command Line Tools: xcode-select --install

2. Install Homebrew

3. Bootstrap everything:

   brew install chezmoi
   chezmoi init --apply https://github.com/zlliang/dotfiles.git

   I use ~/Workspace/github/zlliang/dotfiles as the source directory, so for me:

   chezmoi init -S ~/Workspace/github/zlliang/dotfiles --apply https://github.com/zlliang/dotfiles.git

   This automatically installs Homebrew packages listed below, installs coding agents, and applies configuration for all tools.

4. Set Fish as default shell:

   echo /opt/homebrew/bin/fish | sudo tee -a /etc/shells
   chsh -s /opt/homebrew/bin/fish

5. After initialized, just update the latest changes regularly:

   chezmoi update

What's included

Homebrew packages

• Shell: fish
• Dev toolkits: nodenv, bun, uv, go
• CLI tools: bat, eza, fd, ripgrep, zoxide, gh, fastfetch, hyperfine
• System utilities: chezmoi, Mole
• Desktop apps: Ghostty, Hidden Bar, IINA, Keka, OrbStack, Postman

Coding agents

• Amp: my primary coding agent (profile)
• Codex: CLI and standalone app, via ChatGPT Plus
• Claude Code: CLI only, via my company's API gateway (work laptop) and Vercel AI Gateway (personal laptop)

Configuration

• Fish: shell config and custom functions (~/.config/fish/)
• Git: conditional personal/work identity (~/.gitconfig)
• Ghostty: terminal config (~/.config/ghostty/)
• Amp / Codex / Claude Code: coding agent configs and global skills

Structure

This is a chezmoi source directory. Files use chezmoi naming conventions (dot_, .tmpl, run_onchange_, etc.) and are applied to ~ via chezmoi apply.