pk-plannotator
Private PK build of Plannotator for interactive plan and code review with AI coding agents. Mark up plans or code diffs in a visual UI, review revisions, and send structured feedback back to Claude Code, Copilot CLI, Gemini CLI, OpenCode, Pi, and Codex.
Quickstart
1. Install the CLI
Use npm if you already have Node and Bun installed:
npm install -g pk-plannotator
Or use the hosted installer:
curl -fsSL https://plan.artificialgarden.org/install.sh | bash
Windows PowerShell:
irm https://plan.artificialgarden.org/install.ps1 | iex
2. Verify the command
The npm package installs both command names, and both resolve to this PK build:
pk-plannotator --version
plannotator --version
Both should print pk-plannotator 0.19.22-pk.1.
3. Add the Claude Code plugin
In Claude Code:
/plugin marketplace add kingkillery/pk-plannotator
/plugin install plannotator@plannotator
Restart Claude Code after installing the plugin.
4. Start reviewing
Use plan mode normally, or run one of the helper commands:
/plannotator-review
/plannotator-review <github-pr-url>
/plannotator-annotate <file.md>
/plannotator-last
Share links are hash-only by default for small plans. Large-plan upload is disabled unless you configure PLANNOTATOR_PASTE_URL; when configured, uploaded plans are encrypted before they leave the browser.
Plan Mode Demos:
New: Code Review
Features
| Visual Plan Review | Built-in hook | Approve or deny agent plans with inline annotations |
| Plan Diff | Automatic | See what changed when the agent revises a plan |
| Code Review | /plannotator-review | View git diffs or remote PRs. Package annotations and ask AI about the code as you review. |
| Annotate Any File | /plannotator-annotate | Annotate any markdown file and send feedback to your agent |
| Annotate Last Message | /plannotator-last | Annotate the agent's last response and send structured feedback |
Sharing Plans
Plannotator lets you privately share plans, annotations, and feedback with colleagues. For example, a colleague can annotate a shared plan, and you can import their feedback to send directly back to the coding agent.
Small plans are encoded entirely in the URL hash. No server involved, nothing stored anywhere.
Large plans can use a short link service with end-to-end encryption when PLANNOTATOR_PASTE_URL is configured. Your plan is encrypted with AES-256-GCM in your browser before upload. The server stores only ciphertext it cannot read. The decryption key lives only in the URL you share. Without a configured paste service, sharing falls back to hash-only URLs and uploads nothing.
- Zero-knowledge storage, similar to PrivateBin
- Fully open source and self-hostable (see docs)
Install
Install for Claude Code
Install the plannotator command:
macOS / Linux / WSL:
curl -fsSL https://plan.artificialgarden.org/install.sh | bash
Windows PowerShell:
irm https://plan.artificialgarden.org/install.ps1 | iex
Then in Claude Code:
/plugin marketplace add kingkillery/pk-plannotator
/plugin install plannotator@plannotator
# IMPORTANT: Restart Claude Code after plugin install
See apps/hook/README.md for detailed installation instructions including a manual hook approach.
Install for Copilot CLI
Install the plannotator command:
macOS / Linux / WSL:
curl -fsSL https://plan.artificialgarden.org/install.sh | bash
Windows PowerShell:
