@open-plan-annotator/pi-extension

Pi extension for open-plan-annotator that adds plan review tools and commands

Packages

Package details

extension

Install @open-plan-annotator/pi-extension from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@open-plan-annotator/pi-extension
Package
@open-plan-annotator/pi-extension
Version
1.9.2
Published
Jun 10, 2026
Downloads
1,389/mo · 298/wk
Author
ndom91
License
MIT
Types
extension
Size
5.5 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

npm version License: MIT Platform

A fully local agentic coding plugin that intercepts plan mode and opens an annotation UI in your browser. Mark up the plan, send structured feedback to the agent, and receive a revised version — iterate as many times as you need until you're ready to approve.

Select text to strikethrough, replace, insert, or comment — then approve the plan or request changes

How It Works

  1. Your coding agent (Claude Code or OpenCode) finishes writing a plan
  2. The plugin launches an ephemeral HTTP server and opens a React UI in your browser
  3. You review the plan and annotate it — strikethrough, replace, insert, or comment on any section
  4. Approve to let the agent proceed, or Request Changes to send your annotations back as structured feedback
  5. The agent revises the plan and the cycle repeats until you're satisfied

Everything runs locally. Nothing leaves your machine.

Install

[!NOTE] open-plan-annotator now ships as one package-managed install. The npm package contains the plugin glue and resolves a platform runtime package locally. There is no first-run binary download and no in-app self-update path.

Pi

Install the dedicated Pi package:

pi install npm:@open-plan-annotator/pi-extension

The extension package registers:

  • a annotate_plan tool, exposed to the model with prompt guidance to call it after drafting a concrete markdown plan and before implementation
  • an /annotate-plan command for manual review of the latest assistant message or supplied plan text

Typical flow:

  1. Ask Pi to make a plan before coding.
  2. Pi drafts the plan and calls annotate_plan.
  3. The browser review UI opens locally.
  4. Approval returns “Plan approved. Continue with implementation.”; requested changes return the serialized annotations as feedback.

You can also trigger review manually:

/annotate-plan
/annotate-plan # Plan\n\n1. Do the thing

Manual Install

If you want to run the CLI standalone or install the package globally:

pnpm add -g open-plan-annotator
npm install -g open-plan-annotator

Updates

  • OpenCode: update the installed npm plugin through OpenCode, then restart OpenCode.
  • Claude Code: update the marketplace/plugin install, then restart Claude Code.
  • Standalone/global install: update the npm package (npm, pnpm, or bun), then rerun open-plan-annotator.

The built-in doctor command reports the resolved runtime package and runtime path:

open-plan-annotator doctor

Keyboard Shortcuts

Action Shortcut Description
Delete d Strikethrough selected text
Replace r Replace selected text with new content
Insert s Insert text after the selection
Comment c Attach a comment to selected text
Approve Cmd+Enter Approve the plan and proceed
Request Changes Cmd+Shift+Enter Send annotations back to the agent

Development

bun run dev

Starts the Bun server on port 3847 with a test plan and the Vite dev server on port 5173 with HMR.

bun run lint        # check
bun run lint:fix    # auto-fix
bun run format      # format

Maintainer Docs

License

MIT