⚙️ Helder's Dotfiles

macOS dotfiles managed with chezmoi.

Already using these dotfiles: chezmoi update && chezmoi apply

New Machine

You’ll overwrite existing dotfiles (e.g. ~/.zshrc). Back up anything you care about first.

Prerequisites (run once, requires GUI prompt):

xcode-select --install

Then — one command:

sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply helderberto/dotfiles

This installs chezmoi, pulls the repo, and applies everything: Homebrew, packages, apps, asdf with nodejs, SSH key generation, and Dock config.

If you plan to edit these dotfiles, clone the repo first:

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

After setup

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

Sync Existing Machine

Pull the latest from the repo and apply:

chezmoi update
chezmoi diff    # optional: preview changes
chezmoi apply

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"

Making Updates

Edit the dotfiles in your clone of helderberto/dotfiles, push, then apply:

cd ~/.dotfiles   # or wherever you cloned the repo
git add <file>
git commit -m "..."
git push origin main
chezmoi apply

On other machines, chezmoi update && chezmoi apply is enough.

Reference

License

MIT License © helderberto