Skip to content
PlanBridge

Claude Code

If you have the PlanBridge Claude Code plugin installed (via contextbridge install), Claude’s normal plan-approval hook opens PlanBridge in your browser for review before implementation starts.

Process

Section titled “Process”
  1. Open Claude Code and put the agent into “Plan Mode” (shift + tab or /plan)
  2. Type your prompt for Claude to plan.
  3. When the plan is complete, PlanBridge will open in your browser.
  4. Comment on the plan. This is the perfect time to redirect Claude if it will do something you don’t want.
  5. Submit feedback (with comments) or approve the plan. If you submit feedback, Claude will rework the plan for you. If you approve, Claude will begin implementing.

Accepting a Plan

Section titled “Accepting a Plan”

If you have no feedback on a plan and you want Claude to start implementing, click “Approve Plan”. This will tell Claude to start implementing.

Permission mode after approval

Section titled “Permission mode after approval”

Approving a plan takes the session out of plan mode. Pick the mode it lands in from the gear icon in the review UI, under Settings, “Claude Code”:

  • Auto (the default, matching Claude Code’s): a model classifier decides each permission prompt.
  • Accept Edits: Claude edits files without asking. Other tools still prompt.
  • Manual: Claude asks for anything your settings don’t already allow.

PlanBridge saves the choice to ~/.config/contextbridge/settings.json (or under $XDG_CONFIG_HOME) and applies it to every session. It reads the value when you approve, so a mid-review change still counts.

If a session looks stuck in plan mode after you approve, your Claude Code likely predates the mode you picked. Update it.

Iterating on a Plan

Section titled “Iterating on a Plan”

If you have feedback on a plan, select the relevant text and comment. When you click “Request Changes”, Claude will adjust the plan per your feedback. Once the changes are made, you’ll be re-presented the updated plan.

From here, continue iterating until you’re ready to approve the plan.

Ignore the terminal prompt

Section titled “Ignore the terminal prompt”

When PlanBridge opens, Claude Code keeps its usual approval prompt up in the terminal:

Claude has written up a plan and is ready to execute. Would you like to proceed?


❯ 1. Yes, and use auto mode
  2. Yes, manually approve edits
  3. No, refine with Ultraplan on Claude Code on the web
  4. Tell Claude what to change

Leave it alone. Once you approve or request changes in the browser, PlanBridge dismisses the prompt for you. Approval lands the session in the mode you picked under Settings, “Claude Code” (Auto by default).

Verify

Section titled “Verify”
terminal
contextbridge install status

You should see Claude Code listed as installed.

Re-install or install later

Section titled “Re-install or install later”

If you installed Claude Code after the install script ran, or if install status shows it’s missing, wire it in directly:

terminal
contextbridge install claude

Uninstall

Section titled “Uninstall”
terminal
contextbridge uninstall claude

Or contextbridge uninstall to remove PlanBridge plugin and hook entries from every harness it was installed into.

Open content manually

Section titled “Open content manually”

The plan-mode hook fires automatically.

Reference

Section titled “Reference”