| name | add-package |
| description | Add a package to this macOS dotfiles repo. Use when the user asks to
install, add, or migrate a CLI package or GUI app, for example "add jq",
"ripgrep を入れて", "lazygit 入れたい", "brew install foo を repo 管理に",
"kubectl 追加して". Homebrew owns binaries here; update Brewfile, validate
with brew bundle, apply with brew bundle, and verify the executable.
|
add-package
Add packages through Homebrew. This repo's package management is the top-level
Brewfile.
Decision Flow
-
Identify the package name and whether it is a formula, cask, or non-brew
package.
-
Check Homebrew availability:
brew search <name>
brew info <name>
-
Edit Brewfile:
- CLI tools:
brew "<formula>"
- GUI apps:
cask "<cask>"
- Keep existing grouping and simple alphabetical order where practical.
- Keep package changes in
Brewfile.
- If a repo config, validation command, or agent rule requires the binary,
keep the Homebrew-owned package explicit even when it is already installed
transitively or outside the Brewfile.
-
Validate before applying:
brew bundle check --file Brewfile
- Apply:
brew bundle --file Brewfile
- Verify:
command -v <binary>
<binary> --version
For casks, verify with brew list --cask <name> or by checking the app
exists in /Applications.
Non-Homebrew Packages
