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

1. Install once. The installer detects your harnesses and adds review hooks.
2. Use your harness as you always do.
3. 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

Harness	Hook
Claude Code	PermissionRequest:ExitPlanMode
Codex CLI	Stop

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

• Quickstart
• Install
• How it works
• Usage: Claude Code
• Usage: Codex CLI
• Usage: Other agents
• Privacy & Telemetry

Community

• Slack: Join the ContextBridge community
• Email: [email protected]
• Issues: GitHub Issues

Contributing

PRs and issues welcome. Local setup, the development loop, and the release process live in CONTRIBUTING.md.

License

MIT