Runbooks

Machine setup runbooks designed to be executed by Claude Code. They contain automation instructions, manual step callouts, and Claude-specific notes that guide you through setting up a development machine from scratch.

Bootstrap

On a fresh machine, run the bootstrap script to install Claude Code, Git, and clone this repo. Then launch Claude Code and follow the runbooks.

Windows

Open PowerShell and run:

irm https://raw.githubusercontent.com/TheSevenPens/Runbooks/master/bootstrap/bootstrap-windows.ps1 | iex

This installs Git and Claude Code, then clones the repo to ~/Documents/GitHub/Runbooks.

macOS

Open Terminal and run:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/TheSevenPens/Runbooks/master/bootstrap/bootstrap-mac.sh)"

This installs Homebrew, PowerShell 7, Claude Code, and clones the repo to ~/Documents/GitHub/Runbooks.

After bootstrap

cd ~/Documents/GitHub/Runbooks
claude

Then tell Claude which runbook to follow:

• Machine setup: windows-setup-runbook.md or mac-setup-runbook.md
• Tool versions (mise): mise-env-runbook.md
• Tool versions (conda): conda-env-runbook.md

Repo details

See CLAUDE.md for repo structure, conventions, and instructions for Claude Code.