Skip to main content

Updating

Quick: One Command

,update

This pulls dotfiles, updates all package managers (Homebrew, mise, Cargo, yarn, Gems, Go, uv, manual GitHub releases), and reports what changed.

Useful flags

FlagEffect
--dry-run / -nPreview what would happen without changing anything
--only brew,yarnUpdate only the listed categories
--skip cargo,gemsUpdate everything except the listed categories
--verbose / -vShow extra detail and per-step timings

Categories: dotfiles, brew, gh, mise, cargo, yarn, gems, go, uv, manual.

When multiple categories run in parallel, ,update launches mprocs to give each step its own scrollable terminal pane. Press q to exit after reviewing the logs. If mprocs is not installed, steps run sequentially instead.

Manual Steps (if you prefer granular control)

Update Dotfiles From GitHub (Chezmoi)

chezmoi update

This pulls changes from the source repo and applies them.

If you want to preview first:

chezmoi update --apply=false
chezmoi diff
chezmoi apply

Update Packages

Homebrew itself:

brew update
brew upgrade

Then re-converge your dotfiles (which can run package-management hooks):

chezmoi apply

Verification

,doctor # full ecosystem health check
chezmoi status
chezmoi diff

If package-related hooks ran, spot-check expected package managers:

brew bundle check --global
mise ls --current

Rollback / Undo

  • If a specific repo change caused issues, revert that change in the source repo.
  • Re-apply the previous known-good state:
chezmoi diff
chezmoi apply