macOS setup for one Unix user: packages, shell and Git defaults, runtimes, coding agents, and maintenance. Private identities and secrets stay outside Git.
- New Mac: follow Bootstrap.
- Choose a profile; use it in place of
workstationbelow. - On a configured Mac, preview changes before applying them:
cd ~/projects/dotfiles
./dotfiles diff workstation
./dotfiles apply workstation
./dotfiles check workstationHomebrew packages, identities, and host settings have separate bootstrap steps.
| Task | Guide |
|---|---|
| Choose packages and a user role | Profiles |
| Set up age, Git, SSH, and recovery | Identities |
| Configure shared-host services | Devbox |
| Update software or clean old worktrees | Maintenance |
| Configure coding agents | Agents |
| Edit managed files | Chezmoi |
| Change runtime pins or find tasks | Mise |
| Audit a repository or Mac | Security audits |
| Install mobile and TV tooling | Mobile and TV development |
| Change this repository | Contributing |