WorkstationOperating manual for a developer machine

A repeatable workbench for fresh-machine bootstrap, dotfiles sync, software inventory, project layout, and daily checks.

Setup Pipeline

Restore the machine in phases, from Homebrew and runtimes to workspace dependencies and dotfiles.

Manage shell, editor, and Codex configuration under HOME while masking local secrets in diffs.

Track tools, apps, install state, and official download links with Brewfiles and the software catalog.

Keep checks, dry-runs, project paths, and terminal conventions small enough to copy and rerun.

~/repos/github.com/YunYouJun/workstationready

$ workstation dotfiles doctor

ok home/.zshrc tracked

ok Code/User/settings.json tracked

note run dry-run before touching HOME

$ pnpm software:missing

review Brewfile.apps before installing optional desktop apps

Workflows

Each path keeps recovery and maintenance inspectable, reversible, and easy to rerun.

System Map

Every directory owns a clear boundary so fresh-machine recovery has fewer guesses.

home/chezmoi-compatible source files for the home directory.

packages/cliThe workstation command for checks, diffs, push, pull, and project checkouts.

BrewfileTerminal foundations and daily CLI tools.

Brewfile.appsOptional desktop apps and Mac App Store entries.

docs/Setup decisions, copyable commands, and recovery notes.