Install

Bonsai is distributed through a personal Homebrew tap.

brew tap mggwxyz/tap
brew install bonsai

Check the installed version:

bonsai --version

Requirements

Bonsai is currently macOS-first and expects:

• Homebrew
• Python 3.12, installed by the Homebrew formula
• git
• Caddy, installed by the Homebrew formula
• GitHub CLI (gh) for PR worktrees and PR-aware cleanup

Check prerequisites at any time — this reports anything missing along with the fix:

bonsai doctor --preflight

From Source

For local development:

bun install
bun src/main.ts --help
bun test