Review Spec Kitty Artifacts with PlanBridge
Who is this for (1)
- Stakeholder Persona: Project Owner — Written for the Project Owner reader.
Use this guide when you want inline browser comments on the spec.md, plan.md, and tasks.md files that Spec Kitty creates before implementation begins.
Overview
PlanBridge opens agent plans or local markdown files in a local browser review UI. You highlight text, add comments, approve or request changes, and the feedback returns to your coding harness so the agent can revise the artifact.
Spec Kitty writes planning artifacts under kitty-specs/<feature>/:
kitty-specs/<feature>/spec.mdafter/spec-kitty.specifykitty-specs/<feature>/plan.mdafter/spec-kitty.plankitty-specs/<feature>/tasks.mdafter/spec-kitty.tasks
Spec Kitty already has /spec-kitty.review for completed code. PlanBridge complements that upstream by reviewing the spec, plan, and task markdown before code is written.
Install
Install PlanBridge from plan.contextbridge.ai or from the contextbridge/planbridge GitHub repository.
The shortest install path is:
/bin/sh -c "$(curl -fsSL https://downloads.contextbridge.ai/cli/install.sh)"For a manual install with Homebrew:
brew install contextbridge/tap/clicontextbridge installVerify the install:
contextbridge --versioncontextbridge install statusCodex CLI users may need to trust newly installed hooks before PlanBridge can open inside Codex. Follow the PlanBridge Codex setup notes after contextbridge install.
Manual
After /spec-kitty.specify, open the generated spec for review.
Claude Code:
/planbridge-open the spec you just wroteCodex CLI:
$planbridge-open the spec you just wroteThe agent resolves the path under kitty-specs/<feature>/, sends the markdown to PlanBridge, and revises from your inline comments.
Do the same after /spec-kitty.plan and /spec-kitty.tasks.
Claude Code:
/planbridge-open kitty-specs/my-feature/plan.md/planbridge-open kitty-specs/my-feature/tasks.mdCodex CLI:
$planbridge-open kitty-specs/my-feature/plan.md$planbridge-open kitty-specs/my-feature/tasks.mdAutomatic
To review each artifact without asking, append a snippet to your global agent instructions.
Claude Code:
cat <<'EOF' >> ~/.claude/CLAUDE.md
## Spec Kitty + PlanBridgeWhen `/spec-kitty.specify`, `/spec-kitty.plan`, or `/spec-kitty.tasks` creates a file in `kitty-specs/<feature>/`, open that file with `/planbridge-open`. Use the returned annotations as review feedback, revise the artifact, and only then continue to the next Spec Kitty phase.
EOFCodex CLI:
cat <<'EOF' >> ~/.codex/AGENTS.md
## Spec Kitty + PlanBridgeWhen `/spec-kitty.specify`, `/spec-kitty.plan`, or `/spec-kitty.tasks` creates a file in `kitty-specs/<feature>/`, open that file with `$planbridge-open`. Use the returned annotations as review feedback, revise the artifact, and only then continue to the next Spec Kitty phase.
EOF