Management Tools
Four tools do all the work. Each owns one layer and nothing overlaps.
| Tool | Owns | Source of truth |
|---|---|---|
| chezmoi | every file under ~, the bootstrap scripts | dotfiles/ |
| Homebrew | system packages, libraries, GUI apps, fonts | ~/.config/homebrew/Brewfile |
| mise | CLI tools and language runtimes, per-project pins | ~/.config/mise/config.toml |
| age | the two encrypted files in the repo | ~/.config/chezmoi/key.txt |
The Cloudflare Worker is not part of the machine. It serves the install command.
Order on a fresh machine
Section titled “Order on a fresh machine”- chezmoi renders files and runs
run_once_before_decrypt-age-key. - chezmoi runs
run_onchange_after_brew-bundle, which installs Homebrew and then the Brewfile. - chezmoi runs
run_onchange_after_link-skills, which cloneskiliantyler/skillsand links its skills. Beforegh auth loginthe clone fails with a hint and apply carries on; signing in changes the script’s trigger, so the next apply clones and links. - chezmoi runs
run_once_after_set-login-shell, which needs the bash that step 2 installed. - mise installs each tool the first time its shim is called.