Groundwork

Reference

What's installed — and on which machines.

The setup asks a small set of install-time questions — work machine, whether a Mac is a server/CI machine, password manager, and identity — and those answers decide what gets installed. Here's the inventory by profile, with each line pointing to the page where you learn how it supports the workflow.

Where this comes from

Everything here is declared in one file — the Brewfile — and installed by Homebrew on bootstrap. Plain Homebrew entries track Homebrew's current stable package; when an app has a separate faster-moving channel that we intentionally want, the Brewfile names it explicitly, such as claude-code@latest. The setup answers you gave during setup decide which blocks apply. Change machine type by re-running chezmoi init.

#Both machines

The terminal-first core — installed everywhere, work or personal.

Command line & shell  — see Command line & Shell

git · ghVersion control + the GitHub CLI — see Git
jq · yq · wget · ageJSON/YAML processors, downloader, file encryption
ripgrep · fd · bat · ezaFaster search, find, cat, and ls
git-delta · dust · duf · btop · tokei · hyperfineReadable diffs, disk usage, free space, live system monitor, line counts, benchmarks
starship · antidoteThe prompt and the zsh plugin manager
fzf · zoxide · atuinFuzzy finder, directory jumper, smarter history
yaziVisual file browser with inline preview (the y command) — optional layer over fd/rg/fzf
mise · uv · direnvTool-version manager (Node, Python, etc.), Python project/tool manager, per-folder env
shellcheckStatic analysis for shell scripts, including the bootstrap and helper scripts agents edit
go · rustupGo and Rust toolchains

Editor, multiplexer & Git tools  — see tmux, Neovim, Git

tmux · sesh · tmuxpTerminal multiplexer, smart session switcher, and reusable project layouts
neovim · vimThe editor (LazyVim-configured) and classic vim
lazygit · GitUpTerminal Git UI and a graphical history viewer

Apps, terminal & system  — see Apps, macOS desktop & Keyboard

Ghostty · JetBrainsMono Nerd FontThe terminal window and the Nerd Font used by the prompt and tmux status bar
Karabiner-ElementsThe Caps Lock → Esc/Ctrl remap
Zen · ChromeDaily-driver browser + the testing baseline; use browser-extensions for the curated extension links
Raycast · Anybox · BetterDisplayKeyboard launcher/window manager, Raycast Store checklist via raycast-extensions, bookmarks, and display resolution/control
Slack · ZoomTeam chat and calls
Password manager + CLI1Password or Bitwarden — SSH agent & commit signing
XcodeOptional, only when xcode=true; App Store install for native Apple/iOS development, with first launch and signing still manual
groundwork-help · groundwork-doctor · largest · copy-context · chezmoi · mas · defaultbrowserThe command catalog, read-only machine health report, guided disk-usage helper, AI context copier, dotfiles manager, App Store CLI, default-browser setter: see Commands and Setup

#Personal machines only

Gated off work Macs (confirm your employer allows AI tools before enabling them there).

AI agentsClaude Code, Codex (CLI + app), OpenCode (CLI + app), Grok Build, aider — see Editors & AI
AI chat / localClaude app, ChatGPT app, Ollama (local models for Obsidian's Smart Connections)
EditorsVS Code, Cursor, Zed — see Editors & AI. VS Code and Cursor get a lean extension set for agent context, review, CI, testing, linting, formatting, and project formats.
ObsidianMarkdown notes + your knowledge base
DiaExperimental AI-first browser; uses the Chrome extension links from browser-extensions
IINAMedia player (plays what QuickTime won't)
AppCleanerSmall app-removal helper for plain dragged-in apps; use a vendor uninstaller or Homebrew first when they own the install
Discord · WhatsAppPersonal messaging
Docker DesktopContainers with a GUI (free for personal use)
Unity HubOptional, only when game_dev=true; install Unity 6 LTS and WebGL support inside Unity Hub for the Unity FPS track
C# / Unity VS Code extensionsOptional, only when game_dev=true; C# Dev Kit, runtime support, C# formatting, solution explorer, and NuGet helpers

#Work machines only

Swapped in to keep work Macs license-clean and policy-friendly.

Colima + Docker CLIContainers without Docker Desktop's paid license — colima, docker, docker-compose, docker-buildx
Work VS Code extensionsThe C#/.NET, SQL Server, Kubernetes, and Terraform stack (from vscode-extensions.txt)
Adding something of your own

To install a new app on every machine, add a line to the Brewfile — in the "both machines" area, the personal-only block, or the work-only block — then commit and chezmoi apply. That's how IINA and the rest got here.