backnotprop/plannotator

Plannotator – AIコーディングエージェント向けローカルブラウザベースのレビューUI

何であるか – Plannotatorはクラウドサービスを必要としないデスクトップ専用ツールであり、AI駆動のコーディングアシスタント（Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、Piなど）がプラン、HTML、または完成したコードを生成するたびに、Web UI（または Herdr Annotate を通じたターミナルUI）を開きます。コンテンツにコメントを追加したり、差分にコメントを付けたり、フィードバックをエージェントに送信して出力を修正させることができます。

コア機能

• プラン／ドキュメントレビュー – マークダウン形式のプラン、仕様書、またはURLから取得したページに注釈を加えられます。UIにはインラインコメントと「フィードバックを送信」ボタンが表示されます。
• コードレビュー – ローカルの変更やリモートのPR/MR URL（GitHub、GitLab、GitButler、Perforce）に対応。ファイルツリーと並べて表示される差分で、コメント、ステージ／アンステージ、および「LGTM」と返信できます。
• HTMLアーティファクトレビュー – ロウHTMLをレンダリングし、フィードバックを送信する前にマークアップできます。
• AIインザループ – レビュー中の資料について接続されたLLMに質問できます。また、AI生成のレビューを起動して自動的にコメントを投稿することも可能です。
• ターミナルモード – Herdr Annotate プラグインにより、同じUIがターミナル（Herdr TUI経由）に導入されます。スタンドアロンのTUIも plannotator-tui として利用可能です。

動作方法

1. エージェントがフック（例：ExitPlanMode）を発火します。
2. Plannotatorのローカルサーバーがプランまたは差分を受け取ります。
3. デフォルトのブラウザがレビューUIを開きます。
4. 注釈を加えた後、ツールは同じフック経由で構造化された応答を送信し、エージェントが継続または修正できるようにします。

インストール

• macOS、Linux、WSL、Windows PowerShell向けのワンライナーインストーラー。plannotatorバイナリをダウンロードし、インストール済みエージェントを検出し、必要なフック／スキル／コマンドを記述します。
• --minimal フラグでバイナリのみをインストールし、エージェント固有の統合は省略できます。
• インストーラー実行後、各エージェントごとの簡潔な手順（Amp用のプラグインファイルのコピー、Claude Code用のマーケットプレイスエントリの追加など）に従ってください。READMEには各エージェントの詳細設定へのリンクが記載されています。

使い方のショートカット

/plannotator-annotate README.md                # ローカルファイルを注釈
/plannotator-annotate https://example.com     # URLを取得して注釈
/plannotator-review                           # 現在のgit差分をレビュー
/plannotator-review https://github.com/...    # PR/MRをレビュー
/plannotator-last                             # エージェントの最後の返信を注釈
plannotator sessions                          # 保存済みセッションの一覧表示／開く

（Codexの場合、コマンドは ! または $ で始まります。）

統合

• VS Codeのwebview、Obsidianの自動保存、Bearノート、GitHub/GitLabのPR取得、GitButlerワークスペース、Perforce、リモートSSH／devcontainerポートフォワーディング。
• すべての統合はオプション。コアUIはこれらを一切必要としません。

プライバシーとネットワーク

• テレメトリなし。すべてのプラン、差分、注釈、設定はローカルマシン上に保持され、明示的に共有しない限りネットワークに送信されません。
• ネットワーク通信は、外部リソースの取得時（Jina Readerがデフォルト）や、GitHub/GitLabからPRデータを取得する時、設定されたLLMプロバイダーに質問を送信する時、またはオプションのリンク共有サービスを使用する時のみ発生します（大容量ペイロードはAES-256-GCMでクライアント側で暗号化）。
• インストーラーはGitHubで最新リリースをチェックしますが、コンテンツは一切送信しません。

共有

• 小さなマークダウンスニペットはURLフラグメントにエンコードされ、リンクを持つ誰でも閲覧可能です。
• 大きなペイロードは短縮リンクサービスを使用し、暗号化されたデータのみを保存。復号鍵はフラグメント内に存在します。
• チーム協働用にホストされた「Workspaces」製品が言及されていますが、オープンソースアプリは完全にローカルにとどまります。

セキュリティ

• すべてのバイナリリリースにはSHA-256チェックサムとSLSAプロバンスが付属しています。
• CycloneDX SBOMとGrypeスキャンが各リリースに添付されており、READMEに検証コマンドへのリンクがあります。

アンインストール／完全削除

• plannotator uninstall はバイナリと設定を削除しますが、ローカルデータは保持します。
• plannotator uninstall --purge は確認プロンプト後にすべてのPlannotatorデータを消去します。

結論 – Plannotatorは、AIコーディングアシスタントを使用する際の「人間がループ内にいる」状態を維持できる、集中型のローカルホストUIです。プロプライエタリコードを第三者サービスに送信することなく、プランレビュー、コード差分の注釈、HTMLアーティファクトのフィードバックを提供します。