braeburn
v1.5.2
Published
macOS system updater CLI
Readme
braeburn
A macOS system updater CLI. Keeps tools installed via Homebrew, npm, pip, .NET, and others up to date.
Install
npm install -g braeburnUsage
braeburn # run all enabled steps interactively
braeburn -y # run all steps, auto-accept everything
braeburn homebrew npm # run specific steps onlyCommands
| Command | Description |
|---|---|
| braeburn [steps...] [-y] | Run update steps (default) |
| braeburn log [step] | View the latest output log for a step |
| braeburn config | Show config subcommand help |
| braeburn config list | Print current configuration |
| braeburn config update | Open interactive configuration editor |
| braeburn config update --no-<step> | Disable a step |
| braeburn config update --<step> | Re-enable a step |
Steps
Steps are grouped by system capability. For new setups, braeburn uses a conservative default profile: only package-manager-driven CLI/tooling updates are enabled by default.
| Step | Category | Default (new setup) | Requires |
|---|---|---|---|
| pyenv | Runtimes | off | pyenv or Homebrew |
| nvm | Runtimes | off | ~/.nvm |
| homebrew | Apps & Packages | on | brew (required) |
| mas | Apps & Packages | off | mas |
| macos | Apps & Packages | off | — |
| npm | CLI Tools | on | npm |
| braeburn | CLI Tools | on | npm |
| pip | CLI Tools | on | pip3 |
| dotnet | CLI Tools | on | dotnet |
| ohmyzsh | Shell | off | ~/.oh-my-zsh |
| cleanup (homebrew cleanup) | Maintenance | off | brew |
Requirements
- macOS
- Node.js ≥ 24
- Homebrew (required)
