本文へスキップ
株式会社オブライト
株式会社オブライト

Plannotatorとは

AIエージェントの計画・差分をブラウザで注釈してフィードバックを返す無料ツールの使い方【plan mode・herdr・hunk・GitHub PRレビューとの違い】

2026/11/16に公開約11分で読めます

Plannotator は、AIコーディングエージェントの計画や差分をブラウザで注釈し、そのフィードバックをエージェントに返せるローカル動作のオープンソースツール。無料で、Claude Code・Codex・Gemini CLI など多数に対応する。インストール手順、使い方、plan mode・herdr・hunk・GitHub PRレビューとの違い、データの扱いを公式情報から整理した。

Plannotator は、AIコーディングエージェントが出した計画(プラン)や差分をブラウザ上で注釈し、そのフィードバックをエージェントに返せるローカル動作のレビューツールだ。開発元は backnotprop、ローカルのプラグインは無料のオープンソースで、Claude Code・Codex・Copilot CLI・Gemini CLI・OpenCode など多数のエージェントに対応する。

GitHub のリポジトリは 2025年12月28日に作成され、最初のリリース v0.1.0 は 2025年12月29日に公開された。ライセンスは Apache 2.0 または MIT から選べるデュアルライセンス。2026年11月16日時点のスター数は約 11,800、最新リリースは v0.28.65(2026年11月15日公開)で、GitHub Trending でも今週大きく伸びている。

なぜ今注目されているか

AIエージェントに任せる作業が長くなるほど、「実行前に計画を直したい」「出てきた差分に行単位で指示したい」という場面が増える。ターミナルの文字列に文章で返信するやり方では、どの箇所への指摘かが曖昧になりやすい。Plannotator は、計画や差分を ブラウザ上のレビュー画面 に開き、該当箇所に注釈を付けて返す、という PR レビューに近い体験をエージェントの作業に持ち込む。

公式 README はこのツールを「エージェントを把握し続けるためのワークスペース」と位置づけている。対応範囲も計画レビューにとどまらず、コードレビュー、複数エージェントからのメッセージを集める Inbox、ターミナル向けの Herdr Annotate と Plannotator TUI へと広がっている。リリースは v0.1.0 から 11か月弱で v0.28.65 まで進んでおり、更新が非常に活発だ。

何ができるか

機能内容
計画レビューエージェントの計画に、インラインコメント・削除・置換の注釈を付けて返す。計画の版ごとの差分表示と、下書きの自動保存もある
Annotate計画・仕様・Markdown・HTML・取得した URL に注釈を付けてエージェントへ送る
コードレビューローカルの変更やリモートの PR/MR を差分ビューアで確認。Git・GitButler・Jujutsu・Perforce と GitHub・GitLab に対応。任意で AI レビューや「ask AI」も使える
Plannotator Inbox複数のエージェントからのメッセージ・質問・ファイル・ガイド付きレビューを1つのローカル窓に集め、返信は質問したセッションに戻る
Herdr Annotateターミナル上のテキストや Markdown を、herdr の中でレビューする
Plannotator TUIherdr なしで使える、スタンドアロンのターミナル向け文書レビュー
連携VS Code・Obsidian・Bear・Notion

対応エージェントは、コーディング系が Claude Code・Codex・Copilot CLI・Gemini CLI・OpenCode・Kiro・Droid・Amp・DeepSeek Harness・Pi など。Inbox では Grok Bot・Muse・Hermes・OpenClaw といったパーソナルアシスタント系も対象になる。Claude Code・Pi・OpenCode はプラグインで、それ以外は MCP で Inbox につながる。

インストールと料金

ローカルで動くプラグイン本体は無料のオープンソース。チーム向けのホスト型「Workspaces」は別製品で、公式サイトでは待機リスト(ウェイトリスト)の状態で、料金の記載はない。

環境方法
macOS / Linux`curl -fsSL https://plannotator.ai/install.sh \bash`
Windows(PowerShell)`irm https://plannotator.ai/install.ps1 \iex`
最小構成`curl -fsSL https://plannotator.ai/install.sh \bash -s -- --minimal`
Claude Code/plugin marketplace add backnotprop/plannotator のあと /plugin install plannotator@plannotator
OpenCodeopencode.json に "plugin": ["@plannotator/opencode@latest"] を追加
Pipi install npm:@plannotator/pi-extension
Herdr Annotateherdr plugin install plannotator/herdr-annotate
Plannotator TUIbrew install plannotator/tap/plannotator-tui
# 1. インストールスクリプト(macOS / Linux)
curl -fsSL https://plannotator.ai/install.sh | bash

# 2. Claude Code の場合はプラグインを追加
/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator

# アンインストール(ローカルデータは残す / 完全削除)
plannotator uninstall
plannotator uninstall --purge

使い方 — 最短手順

- 上のコマンドでインストールし、対象のエージェント(例: Claude Code)にプラグインを入れる
- エージェントが計画を提案すると、ブラウザにレビュー画面が開く。注釈を付けて承認するか、フィードバックとして返す
- 作業後の差分は /plannotator-review で開き、行単位のコメントを付けて返す
- 直近のエージェントのメッセージは /plannotator-last、任意のファイルは /plannotator-annotate README.md のように注釈する
- GitHub の PR や GitLab の MR は /plannotator-review <PRのURL> で開ける。認証済みの CLI と Git のリモートで取得する
- Codex ではスラッシュコマンドの代わりに !plannotator … か $plannotator-* スキルを使う

/plannotator-annotate README.md
/plannotator-last
/plannotator-review
/plannotator-review <github-pr-url>

# CLI
plannotator review --patch-file reading.diff
plannotator sessions
plannotator inbox

既存ツールとの違い

観点PlannotatorClaude Code 標準の plan modeherdrhunkGitHub の PR レビュー
役割計画・差分・メッセージへの注釈レビュー計画の承認/却下複数エージェントの並列運用(ターミナルマルチプレクサ)ターミナルの diff ビューアプッシュ後のコードレビュー
画面ブラウザ(TUI もあり)ターミナル内ターミナルターミナルブラウザ(GitHub)
注釈の粒度計画の一部・差分の行単位承認/却下と文章での返信注釈機能は本体にない(Herdr Annotate で連携)AI の注釈をインライン表示行コメント・レビュー
エージェントへ返す直接フィードバックを返せる承認と文章の指示エージェントを並べて動かす主にレビュー用の表示人間同士のやり取りが中心
対応エージェント多数(Claude Code・Codex 等)Claude Code のみ複数エージェントに対応AI エージェント連携を想定エージェントに依存しない
料金ローカル版は無料Claude Code の利用に含まれる無料(Apache-2.0)無料(MIT)GitHub の契約による

使い分けの目安は次のとおり。計画を承認するだけなら標準の plan mode で足りる。計画の特定の段落を直したい、差分の特定行に指示したい、複数のエージェントを同じ画面で扱いたい、といった場合に Plannotator が効く。PR を立てたあとの人間によるレビューは GitHub に残し、その手前のエージェントとのやり取りを Plannotator で詰める、という分担が自然だ。

herdr・hunk と組み合わせる使い方もある。herdr は複数のエージェントをターミナルで並列運用するツールで、Plannotator の Herdr Annotate は herdr の中でターミナルのテキストや Markdown を注釈する(herdr plugin install plannotator/herdr-annotate)。差分を端末で素早く見たいときは hunk が向き、ブラウザで注釈して返したいときは Plannotator、と場面で切り替えられる。エージェントの GUI 側の選択肢は T3 Code の解説も参考になる。なお公式 README では、T3 Code の Claude スレッドも対応エージェントに挙げられている。

注意点・向いている人

- 計画・差分・注釈・下書き・履歴・設定は、既定ではローカルに保存される。公式は使用状況のテレメトリや分析はないとしている
- ただし各画面は読み込み時に GitHub へ最新リリースを確認する。内容は送られないが、GitHub には通常のリクエストが届き、公式ページにはオプトアウトがないと書かれている
- 外部へ内容が出るのは、URL の取得(既定は Jina Reader)、GitHub/GitLab からの取得、Ask AI(設定したプロバイダへ送信)、共有機能を使ったときに限られる
- 共有リンクは、小さいものは URL のフラグメントに圧縮され暗号化されない。大きいものと生の HTML は AES-256-GCM で暗号化してアップロードされ、ホスト型は7日で期限切れになる。共有は PLANNOTATOR_SHARE=disabled で無効にできる
- 従来のリンク共有は互換用で、今後は非推奨に移る方向だと公式に書かれている。チーム共有の主な方向性は、待機リスト中の Workspaces とされている
- 更新が速く(v0.28 系で連日リリース)、機能や画面は変わりやすい。業務で使う場合は版を決めて確認したい
- 向いているのは、Claude Code や Codex の出力を文章だけで直すのに限界を感じている人、PR を出す前にエージェントの成果物を詰めたい人、複数エージェントを並行で使う人

よくある質問

Plannotator は無料ですか。

ローカルで動くプラグインは無料のオープンソースで、ライセンスは Apache 2.0 または MIT から選べる。チーム向けのホスト型 Workspaces は別製品で待機リストの状態であり、公式サイトに料金の記載はない。

Claude Code の plan mode があれば不要ですか。

計画の承認だけなら plan mode で足りる。Plannotator は計画の特定箇所への注釈、差分の行単位のコメント、版ごとの差分表示などをブラウザで行い、フィードバックをエージェントに返せる点が違う。併用もできる。

計画や差分のデータは外部に送られますか。

公式によると、既定ではローカルに留まり、使用状況のテレメトリや分析はない。URL の取得、GitHub/GitLab からの取得、Ask AI、共有を使ったときだけ内容が外に出る。また各画面は最新リリースの確認で GitHub にアクセスし、これにはオプトアウトがないとされている。

Codex でも使えますか。

使える。Codex ではスラッシュコマンドの代わりに !plannotator … か $plannotator-* スキルを使う。

GitHub の PR もレビューできますか。

できる。/plannotator-review <PRのURL> で GitHub の PR や GitLab の MR を開ける。認証済みの CLI と Git のリモートを使って取得し、差分ビューア、ファイルツリー、注釈が使える。

ターミナルだけで使えますか。

使える。herdr の中で動く Herdr Annotate と、herdr なしで動く Plannotator TUI(brew install plannotator/tap/plannotator-tui)がある。

まとめ

Plannotator は、AIエージェントの計画と差分に対して「どこをどう直すか」を注釈で具体的に返すための、無料のローカルレビューツールだ。plan mode の承認/却下より細かく、GitHub の PR レビューより手前の段階を補う位置づけで、herdr や hunk といったターミナル系ツールとも組み合わせられる。まずは対象のエージェントにプラグインを入れ、次の計画を1回レビューしてみるのが早い。

エージェントを使った開発の導入や運用の設計は、ソフトウェア開発やAIコンサルティングでも扱っている。

参考リンク(一次ソース)

株式会社オブライト

株式会社オブライトは、ソフトウェア開発、デジタルサイネージ、Web開発、ネットワークシステム、IoT/AR/VRなどの技術サービスを提供する東京のIT企業です。

この記事に関連する無料ツール(登録不要・その場で結果)

お気軽にご相談ください

お問い合わせ