Helder's Dotfiles

macOS dotfiles managed with chezmoi

Already using these? chezmoi update && chezmoi apply

---

New Machine

Back up existing dotfiles first (e.g. ~/.zshrc) — they will be overwritten.

Prerequisites (run once, requires GUI prompt):

xcode-select --install

Then — clone and bootstrap:

git clone https://github.com/helderberto/dotfiles.git ~/.dotfiles
cd ~/.dotfiles && ./bootstrap.sh

This installs chezmoi, points it at ~/.dotfiles as the source, and applies everything: Homebrew, packages, apps, asdf with nodejs, SSH key generation, and Dock config.

After it finishes:

1. Open a new terminal so shell config and tools are loaded.
2. Add the generated SSH key to GitHub: https://github.com/settings/ssh/new
3. Switch the remote to SSH if you plan to push: git -C ~/.dotfiles remote set-url origin git@github.com:helderberto/dotfiles.git

---

Day-to-day usage

Syncing

chezmoi update && chezmoi apply

Making updates

Edit files in ~/.dotfiles and apply directly — chezmoi reads from the clone:

cd ~/.dotfiles
# edit files
chezmoi apply
git add <file> && git commit -m "..." && git push

On other machines, chezmoi update && chezmoi apply pulls and applies.

Machine-specific config

~/.private is not managed by chezmoi. Put machine-only env vars and secrets there; your shell config sources it automatically.

# in ~/.private
export WORK_API_KEY=...
alias workspace="cd ~/my-company/workspace"

Chezmoi reference

Command	Purpose
chezmoi managed	List all managed paths
chezmoi diff	Preview changes before applying
chezmoi apply	Apply dotfiles to ~

Development

Testing

./test-chezmoi.sh              # syntax & config checks
./test-chezmoi.sh --post-apply # also validates installed tools

CI runs the test suite on every push and PR via GitHub Actions.

AI agent config

AGENTS.md is the source of truth for agent instructions. ~/.claude/CLAUDE.md symlinks to it, so it works with Claude Code, Open Code, and other tools that look for either file.

Curated SDLC skills (PRD → ship) live in a separate plugin: helderberto/agent-skills. Install via /plugin marketplace add helderberto/agent-skills in Claude Code.

---

MIT License © helderberto