PlanBridge
Website | Quickstart
Review your agent's plan the way you review code.
PlanBridge intercepts your AI coding agent's plan so you can mark up any line and leave precise feedback. The agent adjusts before writing the first line of code. It runs locally, hooks into Claude Code and Codex CLI, and sends your plan content nowhere.
Install
/bin/sh -c "$(curl -fsSL https://downloads.contextbridge.ai/cli/install.sh)"
The script uses Homebrew when available and falls back to a tarball into $HOME/.local/bin. After the binary lands, it runs contextbridge install to wire up any supported AI coding harness it finds.
Prefer to install yourself?
brew install contextbridge/tap/cli
contextbridge install
For tarball installs, alpha channel, and flag reference, see Install.
Quick start
- Install once. The installer detects your harnesses and adds review hooks.
- Use your harness as you always do.
- When your agent produces a plan, your browser opens. Annotate, approve, or request changes. Your decision flows back to the harness.
Full walkthrough: Quickstart.
Supported harnesses
Using something else (Cursor, Aider, opencode, Gemini CLI, Aether)? Any agent that runs shell commands and parses JSON can pipe a plan to contextbridge plan and act on the response. See Other agents.
Privacy
Your plan content stays on your machine. No remote backend, no account, no API keys. The CLI sends anonymous product analytics and crash reports unless you opt out with DO_NOT_TRACK=1 or CONTEXTBRIDGE_TELEMETRY_DISABLED=1. Details: Privacy & Telemetry.
Verify what you're running
PlanBridge is open source (this repo, MIT), and GitHub Actions builds the released binaries straight from it. Every release archive comes with GitHub build provenance: a Sigstore-signed attestation that ties the archive back to the commit and CI workflow that built it, recorded in a public transparency log. Verify a download with:
gh attestation verify contextbridge_<version>_darwin_arm64.tar.gz --repo contextbridge/planbridge
macOS binaries are signed and Apple-notarized on top of that.
Documentation
Community
Contributing
PRs and issues welcome. Local setup, the development loop, and the release process live in CONTRIBUTING.md.
License
MIT
