⚙️ 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

Open a new terminal so shell config and tools are loaded.
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

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

Name	ship
Description	This skill should be used when the user asks to "ship", "commit and push", "add all and push", or requests staging all changes, committing, and pushing.

ship

SKILL.md