Install Playbook, set it up, and take one change from an idea to a pull request. This page is for someone who already uses Claude Code in a Git repository.
- You are new to Playbook and want the shortest path to a first use.
- You installed it and want to know what to run next.
Claude Code (claude), bash or zsh, git and shasum. The gh command is optional. The install guide lists why each one matters.
brew install amplifiedengineer/tap/playbookWith no Homebrew, run the install script. It checks the release checksum before it installs anything:
curl -fsSL https://raw.githubusercontent.com/amplifiedengineer/playbook/main/install.sh | bashTo add the plugin to a binary that did not come from Homebrew, run playbook plugin install. The install guide covers Nix and Windows.
playbook setupIn a terminal, setup shows one step at a time, says what each step changes and asks before it does anything. It offers to install the Claude Code plugin when it finds claude. To preview every change first, run playbook setup --dry-run. What setup installs lists each change and how to undo it.
Check the result:
playbook doctor checkThe table shows which of the seven layers are in place. Inside Claude Code, /playbook:doctor shows the same table.
pb ccpb is a short name for playbook. pb cc starts Claude Code with the Playbook system prompt, the right model chain and your effort ceiling. It resumes the last session in this directory, or starts a new one. pb cc list shows recent sessions.
In the session, give Playbook an idea:
/playbook:plan "add a --json flag to the export command"
The plan command reads your code, asks only what it cannot find out, and checks the plan with three reviewers before it asks you to approve. It saves the plan in your plans folder.
Build the plan:
/playbook:implement
With no argument, implement lists your saved plans and builds the one you pick. It splits the plan into Segments. Each Segment becomes one small pull request, and each Work Unit becomes one commit. Before it writes code it asks how to deliver them.
Review the result:
/playbook:review
Review picks quick or deep, says why, and runs it.
For a small bug, /playbook:fix goes from a failing test to one pull request. For a decision that is hard to undo, /playbook:adr records it.
On Homebrew, run brew upgrade playbook. For an install script install, run playbook upgrade, which updates the plugin too. See Upgrade in the install guide.
- Plan and implement walks through both commands in detail.
- Concepts explains how the plugin, the binary and the hooks fit together.
- Docs map links every page.