Renamed. The GitHub organization was
pragmatic-engineer. It is nowamplifiedengineer. This tap is nowamplifiedengineer/tap. It waspragmatic-engineer/tap, and before thatpragmatic-engineer/playbook. If you installed from an old tap, remove the old install and install again: runbrew uninstall playbook, thenbrew untap pragmatic-engineer/tap, thenbrew install amplifiedengineer/tap/playbook. Addpbtopto the first command if you installed it. If you used the oldest tap name, untappragmatic-engineer/playbookas well. Your data stays in~/.config/playbook. More in Moved to the amplifiedengineer org.
Homebrew tap for the amplifiedengineer/playbook toolkit and for Helios, a keyboard-first terminal client for reviewing pull requests and watching CI.
| Formula | Install | What it is |
|---|---|---|
playbook |
brew install amplifiedengineer/tap/playbook |
The Claude Code plugin toolkit and its binary. It links pbtop to playbook. |
pbtop |
brew install amplifiedengineer/tap/pbtop |
The token and cost dashboard, for a machine without playbook. |
helios |
brew install amplifiedengineer/tap/helios |
The Helios terminal client. The formula appears at the first Helios release. It is not installable yet. |
brew install amplifiedengineer/tap/playbookUpgrade with brew upgrade playbook. The formula links pbtop to playbook, so one upgrade updates both and you do not install pbtop separately.
The pbtop formula is for a machine without playbook, and the two formulas conflict because both own the pbtop file. If you installed pbtop before, run brew uninstall pbtop once, then brew reinstall playbook. Homebrew refuses to upgrade playbook while the old pbtop is installed, and its message names that command.
Homebrew 6.0.0 and later asks you to trust non-official taps. Installing a fully qualified name, as above, trusts only that formula.
The install records that trust, so a later brew upgrade playbook works by short name. Without it, Homebrew stops with Refusing to load formula ... from untrusted tap and names the command to run. To install by short name without the full name first, run brew tap amplifiedengineer/tap, then brew trust --formula amplifiedengineer/tap/playbook. For pbtop, trust amplifiedengineer/tap/pbtop. For Helios, once its formula exists, run brew trust --formula amplifiedengineer/tap/helios.
The broader option is brew trust amplifiedengineer/tap. It covers every current and future formula in the tap.
Run brew trust to list what you trust. Run brew untrust <target> to remove an entry, with --formula for a formula.
Each formula downloads the prebuilt binary that the amplifiedengineer/playbook release workflow builds, attests and checksums. It does not build from source. It uses the same SHA256SUMS that install.sh checks.
The helios formula does the same with the archives that the Helios release workflow builds and checksums. It downloads one helios-<version>-<target>.tar.gz per target. Each holds the single helios binary. The platforms are the same four as below.
Platforms: macOS (Apple Silicon and Intel) and Linux (x86_64 and arm64, static musl builds). Windows is not a Homebrew target. Use install.sh or WSL.
This repo was named homebrew-playbook, and the old command was brew install pragmatic-engineer/playbook/playbook. To switch, run brew untap pragmatic-engineer/playbook, then install from amplifiedengineer/tap. If brew untap refuses, uninstall playbook first.
The GitHub organization is now amplifiedengineer. It was pragmatic-engineer. The tap is amplifiedengineer/tap. To move an existing install, run these commands. Homebrew refuses brew untap while a formula from the tap is installed, so uninstall first, and add pbtop to the first command if you installed it:
brew uninstall playbook
brew untap pragmatic-engineer/tap
brew install amplifiedengineer/tap/playbookTo keep the installed formula and the old tap name, point the tap at the new address instead:
git -C "$(brew --repository pragmatic-engineer/tap)" remote set-url origin https://github.com/amplifiedengineer/homebrew-tap.git
brew updatebrew tap --repair does not move a tap to a new organization. Your playbook data stays in ~/.config/playbook.
A release of amplifiedengineer/playbook opens a pull request here that updates playbook and pbtop together. A scheduled workflow is the fallback. Helios has its own releases. The scheduled workflow opens a bump/helios-v<version> pull request for each one, and creates Formula/helios.rb at the first release. The playbook formula also installs pbdoc and pbsync into the same bin from per-target pbdoc-<version>-<target>.tar.gz and pbsync-<version>-<target>.tar.gz resources when the release lists all four of each. Do not edit URLs or checksums by hand. See docs/release-automation.md.
See SECURITY.md.