Plannotator

Interactive Plan Review for AI Coding Agents

1 — 概要
何か

Plannotator は、AI コーディングエージェント（Claude Code、OpenCode、Pi、Codex）が立てた「実装プラン」をブラウザ上でビジュアルにレビューし、承認または修正依頼をそのままエージェントに返すためのツール群。プランにインラインで注釈（削除・挿入・置換・コメント）を付け、チームで共有したり、差分表示で変更履歴を確認したりできる。

4対応エージェント
Hook / UIプラン表示・注釈
Plan Diff改訂差分
E2E 暗号化共有（大きいプラン）
2 — 機能
主な機能
機能きっかけ説明
Visual Plan Review組み込み Hookプランを承認 or 却下。インライン注釈で修正指示
Plan Diff自動エージェントがプランを改訂したときの差分を表示
Code Review/plannotator-reviewgit diff を行単位で注釈し、フィードバックをエージェントに送る
Annotate Any File/plannotator-annotate任意の Markdown ファイルに注釈し、エージェントにフィードバック送信
3 — インストール
対応エージェント別

いずれも「plannotator コマンド」のインストールが必要な場合は、以下で取得する。

# macOS / Linux / WSL
curl -fsSL https://plannotator.ai/install.sh | bash

# Windows PowerShell
irm https://plannotator.ai/install.ps1 | iex

Claude Code

プラグインを入れたあと、Claude Code を再起動する。

/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator

OpenCode

opencode.json に "plugin": ["@plannotator/opencode@latest"] を追加。上記インストールスクリプト実行で /plannotator-review も有効になり、OpenCode 再起動で反映。

Pi

pi install npm:@plannotator/pi-extension

--plan でプランモード起動、またはセッション中に /plannotator で切り替え。

Codex

コマンドインストール後、Codex 内で !plannotator review（コードレビュー）や !plannotator annotate file.md（Markdown 注釈）を使用。プランモードは未対応。

4 — フロー
プランから実装まで
  1. エージェントがプランを作成し終える（例: Claude Code の ExitPlanMode）
  2. Plannotator の Hook が発火し、ブラウザで Plannotator UI が開く
  3. プランをビジュアルに注釈（削除・挿入・置換・コメント）
  4. 承認 → エージェントが実装フェーズへ進む
  5. 変更依頼 → 注釈が構造化フィードバックとしてエージェントに渡り、プラン改訂後に再度レビュー可能（Plan Diff で差分表示）
5 — 共有
プランの共有方法

プラン・注釈・フィードバックをチームメンバーと共有できる。

  • 小さいプラン: データは URL のハッシュにすべて載る。サーバ不要・ブラウザ外に出ない。
  • 大きいプラン: 短縮リンクサービスを利用。ブラウザ側で AES-256-GCM 暗号化してからアップロードするため、サーバは暗号文のみ保持（ゼロ知識）。復号鍵は共有する URL に含まれ、サーバには送らない。ペーストは 7 日で自動削除。
プライバシー: アカウント・トラッキング・Cookie は共有ポータルに不要。オープンソースでセルフホスト可能（公式ドキュメント 参照）。
公式・関連