backnotprop/plannotator

Plannotator – AIエージェント中心の注釈・レビューツール

概要

• ローカルで動作するブラウザベース（およびターミナルベース）のUIで、さまざまなAIコーディングエージェント（Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、Pi）に対して注釈、レビュー、フィードバック送信ができます。
• エージェントのコマンド/スキルシステムにフックすることで動作します。エージェントがプラン、HTMLアーティファクト、または完成したコードを生成すると、PlannotatorはWebページ（またはTUI）を開き、インラインでコメントを付け、そのコメントをエージェントへの次のメッセージとしてプッシュバックできます。

主な機能

領域	できること
プラン・ドキュメントレビュー	Markdownプラン、仕様書、任意のURLを開き、インラインで注釈を付け、プランを承認または拒否できます。エージェントは構造化されたフィードバックを受け取り、プランを修正できます。
コードレビュー	ローカルの差分、未コミットの変更、GitHub/GitLabのリモートPR/MRをレビューできます。Git、GitButler、Jujutsu（jj）、Perforce（p4）に対応。行に注釈を付け、ファイルをステージ/アンステージし、「LGTM」または詳細なコメントをエージェントに送信できます。
HTMLアーティファクトレビュー	任意のHTML（または生のHTML）をレンダリングし、レンダリングされたビューに注釈を付けられます。
ターミナルUI（Herdr Annotate）	Herdrターミナルエディタ用のTUIプラグインで、コマンドラインに同じ注釈エクスペリエンスをもたらします。スタンドアロンTUI（plannotator-tui）も利用可能です。
Ask-AI & AI駆動レビュー	UI内で、レビュー中のコンテンツについて設定済みのLLMに質問したり、差分に自動的にコメントを投稿するAI生成レビューを起動したりできます。
共有	プランや注釈付きドキュメントをショートリンク（AES-256-GCM暗号化ペイロード）でエクスポートしたり、小さなMarkdownをURLフラグメントに直接埋め込んだりできます。レガシーなリンク共有UIはまだ存在しますが、ホスト型のWorkspaces製品に置き換えられつつあります。
統合	VS Code Webview、Obsidianボールトの自動保存、Bearノート、SSH/devcontainerポート処理。

対応エージェント（標準対応）

• Claude Code、Codex、Copilot CLI、Gemini CLI、OpenCode、Kiro、Droid、Amp、Pi。
• インストーラーは、これらのうちどれが存在するかを自動検出し、それぞれに必要なフック、スラッシュコマンド、またはスキルを作成します。

インストール

# macOS / Linux / WSL – ワンライナーインストーラー
curl -fsSL https://plannotator.ai/install.sh | bash

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

• スクリプトはGitHub Releasesからplannotatorバイナリをダウンロードし、インストール済みのエージェントを検出して、必要な設定ファイル（フック、プラグイン、スラッシュコマンドなど）を書き込みます。
• --minimal（またはPLANNOTATOR_MINIMAL=1）はバイナリのみをインストールし、エージェント固有の設定は手動で追加する必要があります。
• インストーラが完了したら、READMEのエージェントごとの「インストーラ実行後」の表に従って、プラグインファイルをコピーするか、マーケットプレイスコマンドを実行するか、そのままエージェントを使い始めます（Codex、Gemini、Kiroは追加の手順は不要です）。

典型的なワークフロー

1. プランモード – コマンドは不要です。エージェントがプランを出力すると、Plannotatorが自動的にブラウザタブを開きます。
2. 注釈 – コメントを追加、承認、または拒否します。フィードバックはエージェントセッションに送り返されます。
3. コードレビュー – /plannotator-review（または同等のスキル）を実行して差分ビューアを開き、注釈を付けて、レビューをエージェントに送り返します。
4. HTMLレビュー – /plannotator-annotate <file.html> --render-html を使用して、レンダリングされたページを表示・コメントできます。
5. ターミナル – Herdr内で herdr plugin install plannotator/herdr-annotate を実行し、TUIで同じコマンドを使用します。

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

• すべてのプラン、差分、注釈、設定はデフォルトでマシン上に留まります。テレメトリは収集されません。
• 送信リクエストは以下のみです：
  • GitHub上の最新のPlannotatorリリースを確認するための1回限りのチェック（--no-git-remote-checkまたはPLANNOTATOR_GIT_REMOTE_CHECK=0で無効化可能）。
  • リモートのWebページに注釈を付ける際のオプションのURLフェッチ（デフォルトではJina Reader経由）。
  • Ask AIまたはAI生成レビューを使用する際の、設定済みLLMプロバイダーへの呼び出し – 選択した質問と関連コンテキストのみが送信されます。
  • 共有サービス：ショートリンクのアップロードはペイロードをクライアント側で暗号化。サーバーは暗号文のみを保存します。
• 詳細なプライバシーポリシーはREADMEにリンクされています。

アンインストール / パージ

plannotator uninstall          # バイナリ、フック、設定を削除しますが、ローカルデータは保持します
plannotator uninstall --purge # 確認プロンプトの後、Plannotatorが所有するすべてのデータを削除します

どちらのコマンドも、誤ったデータ損失に対する安全策です（ルート/ホームディレクトリの削除を拒否し、明示的なpurgeという文言を要求し、ドライラン・モードを提供します）。

誰に向いているか？

• LLMを活用したコーディングアシスタントを使用していて、エージェントが先に進む前に人間が介在するレビューステップを希望する開発者。
• リポジトリ全体を公開せずに注釈付きプランやコードレビューを共有する必要があるチーム（暗号化されたショートリンク共有、または今後提供予定のWorkspaces製品）。
• 視覚的な差分/注釈UIを好むが、フィードバックをAIエージェントに自動的に消費させたいユーザー。

結論 Plannotatorは、プラン、仕様、コード差分、HTMLアーティファクトを、基盤となるコーディングエージェントと直接対話するインタラクティブなレビューサーフェスに変換することで、AI生成出力と人間による監視のギャップを埋めます。AI支援開発の安全性と生産性を向上させることを目的とした、本格的なオープンソースソフトウェアプロジェクトです。

---

Plannotator – AIエージェント向けインタラクティブ注釈・レビューUI

概要 Plannotatorは、オープンソースでローカル実行されるブラウザ（およびターミナル）UIであり、AIコーディングエージェント（Claude Code、Codex、Copilot CLI、Geminiなど）が生成したプラン、仕様、コード差分、HTMLアーティファクトに注釈を付けることができます。注釈は構造化されたフィードバックとしてエージェントに送り返され、人間が介在するレビューステップを実現します。Git/GitHub/GitLabに対応し、VS Code、Obsidian、Bearと統合され、暗号化されたリンク共有も提供します。インストールはワンライナースクリプトで、エージェントを自動検出します。明示的に共有しない限り、すべてのデータはローカルに留まります。

タイトル: Plannotator – AIコーディングエージェント向けインタラクティブ注釈・レビューUI