2026-05-14 18:22 UTCIn-site rewrite2 min readUpdated: 2026-06-30 13:03 UTC

Show HN: PlanBridge: open-source tool for precise feedback on coding agent plans

PlanBridge is an open-source tool that lets you review AI coding agent plans like code. It intercepts the plan, allows line-by-line annotation, and sends feedback back to the agent before it writes code. Runs locally, supports Claude Code and Codex CLI, and ensures privacy.

SourceHacker News AIAuthor: floodfx

Notifications You must be signed in to change notification settings

Fork 0

Star 16

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

59 Commits

.aether

.agents/skills/open-github-issue

.claude

.codex

.contextbridge

.github

.projen

harnessIntegrations

just

packages

scripts

tools @ cc8956c

.gitattributes

.gitignore

.gitmodules

.goreleaser.yaml

.mcp.json

.pre-commit-config.yaml

.prettierignore

.release-please-manifest.json

.tool-versions

AGENTS.md

CHANGELOG.md

CLAUDE.md

CONTRIBUTING.md

LICENSE

README.md

bun.lock

bunfig.toml

entitlements.plist

eslint.config.mjs

justfile

package.json

release-please-config.json

tsconfig.base.json

tsconfig.json

zizmor.yml

Repository files navigation

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

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.

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

About

Review your agent's plan the way you review code.

plan.contextbridge.ai

Resources

Readme

License

MIT license

Contributing

Uh oh!

There was an error while loading. Please reload this page.

Activity

Custom properties

Stars

16 stars

Watchers

3 watching

Forks

0 forks

Report repository

Releases 14

v0.5.0

Latest

May 13, 2026

+ 13 releases

Packages 0

Uh oh!

There was an error while loading. Please reload this page.

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

TypeScript 94.4%

Shell 2.4%

CSS 1.7%

JavaScript 0.5%

Just 0.5%

Handlebars 0.2%

Other 0.3%