Skip to content
PlanBridge

Quickstart

One command installs the binary and wires PlanBridge into the AI coding harnesses on your machine. From there you can open any file or your agent’s last message on demand, or let PlanBridge open automatically when your agent finishes a plan.

1. Install

Section titled “1. Install”
terminal
/bin/sh -c "$(curl -fsSL https://downloads.contextbridge.ai/cli/install.sh)"

The script uses Homebrew if installed, otherwise places the binary into $HOME/.local/bin. After, it runs contextbridge install to add standard hooks or plugin entries to supported AI coding harnesses it finds.

Prefer to step through the install yourself? See Install for manual installation details.

2. Try PlanBridge Now

Section titled “2. Try PlanBridge Now”

The quickest way to see PlanBridge: pull an existing markdown file into the review UI. No plan mode required.

/planbridge-open path/to/file.md

Once your agent has written something, you can also open its last message for markup:

/planbridge-last

That’s two of the three ways to use PlanBridge. The third is the automatic plan-mode flow below.

3. Use plan mode

Section titled “3. Use plan mode”

Put your agent in plan mode and PlanBridge runs automatically. When your agent finishes a plan, it opens on its own, no command needed:

  1. Your browser opens to the review UI.
  2. You select text and comment, or approve as-is.
  3. Your decision flows back to the harness, which revises the plan or starts implementing once you approve.
Example: Claude Code's plan opening in PlanBridge.

Per-harness notes

Section titled “Per-harness notes”

Anything harness-specific (verifying the install, custom hook setup, known quirks) lives on its own page:

No supported harness?

Section titled “No supported harness?”

If you’re using something else (Cursor, Aider, opencode, Gemini CLI, etc.), you can still wire PlanBridge in by telling your agent to pipe its plan to contextbridge plan and act on the JSON response. See Other agents.