このページの翻訳は LLM によって生成されています。誤りに気づいた場合は GitHub で issue を開いてお知らせください。

インテグレーション

Herdr は対応するエージェントを自動的に検出します。エージェントのインテグレーションをインストールすると、サーバーの再起動後に Herdr が同じセッションを resume できます。一部のインテグレーションはエージェントの状態も直接報告します。Herdr が対応するエージェントと、自ら Herdr に対応するエージェントについてはエージェントを参照してください。

エージェントネイティブのセッション復元、直接のライフサイクル報告、またはその両方が欲しいときにインテグレーションを使ってください。状態権威モデルの全体像はエージェントを参照してください。

インテグレーションをインストールする

Herdr 内で設定を開き、インテグレーションタブから PATH 上で見つかったエージェント向けの推奨インテグレーションをインストールするか、コマンドを手動で実行します:

herdr integration install pi
herdr integration install omp
herdr integration install claude
herdr integration install codex
herdr integration install copilot
herdr integration install devin
herdr integration install droid
herdr integration install kimi
herdr integration install opencode
herdr integration install kilo
herdr integration install hermes
herdr integration install mastracode
herdr integration install qodercli
herdr integration install qwen
herdr integration install letta
herdr integration install cursor
herdr integration install antigravity-cli
herdr integration install grok

インテグレーションをアンインストールする

herdr integration uninstall pi
herdr integration uninstall omp
herdr integration uninstall claude
herdr integration uninstall codex
herdr integration uninstall copilot
herdr integration uninstall devin
herdr integration uninstall droid
herdr integration uninstall kimi
herdr integration uninstall opencode
herdr integration uninstall kilo
herdr integration uninstall hermes
herdr integration uninstall mastracode
herdr integration uninstall qodercli
herdr integration uninstall qwen
herdr integration uninstall letta
herdr integration uninstall cursor
herdr integration uninstall antigravity-cli
herdr integration uninstall grok

Herdr は Linux/macOS の統合設定と全プラットフォームの新規ファイルをアトミックに保存し、Windows の既存ファイルは権限を維持するため、バックアップ後に同じファイルを更新します。Windows でバックアップが通知された場合は、再試行前にエージェントを終了して設定を確認し、未完了の .herdr-backup.pending は復旧元に使わず設定が正しいことを確認してから削除するか、必要なら完成済みの .herdr-backup の内容を既存ファイルに書き戻し（ファイルがない場合は先に意図した権限を設定）、設定が正しいことを確認してからバックアップを削除してください。

Herdr がインテグレーションをどう使うか

どのインテグレーションも、エージェントが今どのセッションにいるかを Herdr に伝えるので、サーバーの再起動後に Herdr がそのセッションを resume できます。[session] resume_agents_on_restore = false で無効にできます。

Pi、OMP、Kimi Code CLI、OpenCode、Kilo Code CLI、MastraCode のインテグレーションは、エージェントの状態も報告します。報告している間、Herdr は画面を読む代わりにその報告を使います。その他のインテグレーションでは、状態は画面検出に任せます。

エージェントネイティブのセッション復元には最新の Herdr インテグレーションが必要です: Pi インテグレーションはバージョン 2、OMP は 3、Claude Code は 6、Codex は 5、GitHub Copilot CLI は 2、Devin CLI は 2、Droid は 2、Kimi Code CLI は 3、Qoder CLI は 2、Qwen Code は 1、Letta Code は 1、Cursor Agent CLI は 1、Grok CLI は 2、OpenCode は 5、Kilo Code CLI は 1、Hermes Agent は 5、MastraCode は 1、Antigravity CLI は 1 です。インストール済みバージョンは herdr integration status で確認してください。

独自エージェントを統合する

コーディングエージェントを開発している場合は、Herdr にネイティブサポートを追加せずに、自分のコードからエージェントの状態と resume コマンドを Herdr に報告できます。エージェントに Herdr 対応を追加するを参照してください。

Pi

Pi インテグレーションをインストールします:

herdr integration install pi

Herdr はバンドルされた拡張を次の場所に書き込みます:

~/.pi/agent/extensions/herdr-agent-state.ts

PI_CODING_AGENT_DIR が設定されている場合は、代わりに $PI_CODING_AGENT_DIR/extensions/herdr-agent-state.ts に書き込みます。Pi の agent ディレクトリが存在する場合、Herdr は extensions ディレクトリを作成します。アンインストールはその拡張ファイルだけを削除します。

OMP

OMP インテグレーションをインストールします:

herdr integration install omp

Herdr はバンドルされた拡張を次の場所に書き込みます:

~/.omp/agent/extensions/herdr-omp-agent-state.ts

PI_CODING_AGENT_DIR が設定されている場合は、代わりに $PI_CODING_AGENT_DIR/extensions/herdr-omp-agent-state.ts に書き込みます。OMP の agent ディレクトリが存在する場合、Herdr は extensions ディレクトリを作成します。アンインストールはその拡張ファイルだけを削除します。

OMP インテグレーションは、Herdr のソケット API を通じてエージェントラベル omp、ライフサイクル状態、ネイティブセッション識別を報告します。omp 実行ファイルのネイティブプロセス検出は不要で、Herdr はサーバー再起動後に omp --resume=<session> で OMP ペインを resume できます。

Claude Code

Claude Code フックをインストールします:

herdr integration install claude

このフックは、セッション開始時に Claude Code のセッション識別をローカルの Herdr ソケットに報告します。Claude Code の状態は Herdr のスクリーンマニフェスト検出から得られます。

Claude 統合 v10 は、文書化された SessionStart の source 値 startup、resume、clear、compact、fork のみに一致します。これにより、ほかの Claude 互換フックを無効にせずに、Grok の new と load イベントがインポートされた Herdr の Claude フックを起動するのを防ぎます。アップグレード後に Claude 統合を再インストールして、従来のワイルドカードマッチャーを移行してください。Claude に新しい source 値が追加された場合は、統合の更新が必要です。

Herdr はデフォルトで ~/.claude を使い、CLAUDE_CONFIG_DIR が設定されていればそちらを使います。Claude の設定ディレクトリはあらかじめ存在している必要があります。インストールは hooks/herdr-agent-state.sh を書き込み、settings.json に Herdr のフックエントリを追加します。アンインストールは一致するフックエントリを削除し、フックスクリプトを削除します。

Codex

Codex フックをインストールします:

herdr integration install codex

Codex フックは、他のインテグレーションと同じローカルソケット API を通じてセッション識別を報告します。Codex の状態は Herdr のスクリーンマニフェスト検出から得られます。

Herdr はデフォルトで ~/.codex を使い、CODEX_HOME が設定されていればそちらを使います。Codex の設定ディレクトリはあらかじめ存在している必要があります。インストールは herdr-agent-state.sh を書き込み、hooks.json を更新し、config.toml に [features] hooks = true があることを保証します。非推奨のトップレベル codex_hooks フラグが存在すれば削除もします。アンインストールは hooks.json から Herdr のエントリを削除してフックスクリプトを削除しますが、config.toml は変更しません。

GitHub Copilot CLI

GitHub Copilot CLI フックをインストールします:

herdr integration install copilot

Copilot フックは、他のインテグレーションと同じローカルソケット API を通じてセッション識別を報告します。Copilot の状態は Herdr のスクリーンマニフェスト検出から得られます。

Herdr はデフォルトで ~/.copilot を使い、COPILOT_HOME が設定されていればそちらを使います。Copilot の設定ディレクトリはあらかじめ存在している必要があります。インストールは hooks/herdr-agent-state.sh を書き込み、settings.json に SessionStart フックエントリを追加します。アンインストールは settings.json から Herdr のエントリを削除し、フックスクリプトを削除します。

Copilot がセッション情報を含むイベントを発行した後、Herdr は報告されたセッション id を使って copilot --resume=<id> でペインを resume できます。

Devin CLI

Devin CLI フックをインストールします:

herdr integration install devin

このフックは、Devin のセッション、プロンプト、ツール使用、許可、停止の各イベントからネイティブセッション識別を報告します。Devin のフックはすべての許可キャンセルやユーザー割り込みの後に信頼できる状態遷移を発行しないため、Devin の状態は引き続き Herdr のスクリーンマニフェストと OSC 検出から得られます。

XDG_CONFIG_HOME が設定されていれば、Herdr は $XDG_CONFIG_HOME/devin を使います。それ以外では、Linux と macOS では ~/.config/devin、Windows では %APPDATA%\devin を使います。Devin の設定ディレクトリはあらかじめ存在している必要があります。インストールは Unix では herdr-agent-state.sh、Windows では herdr-agent-state.ps1 を書き込み、config.json に Herdr のフックエントリを追加します。フックは Devin の実行中にセッション参照を更新します。アンインストールは config.json から Herdr のエントリを削除し、フックスクリプトを削除します。

Herdr は保存された Devin セッションを devin --resume <id> で resume します。フックのインストール有無にかかわらず、スクリーンマニフェスト検出が状態の権威のままです。

Kimi Code CLI

Kimi Code CLI フックをインストールします:

herdr integration install kimi

このフックは、ネイティブ復元と権威ある idle、working、blocked 状態のために、Kimi のセッション識別とライフサイクル状態を Herdr に報告します。Kimi Code CLI 0.14.0 以上が必要です。

Herdr はデフォルトで ~/.kimi-code を使い、KIMI_CODE_HOME が設定されていればそちらを使います。Kimi Code の設定ディレクトリはあらかじめ存在している必要があります。インストールは hooks/herdr-agent-state.sh を書き込み、config.toml に Herdr 管理の [[hooks]] エントリを追記します。アンインストールは Herdr 管理の設定ブロックを削除し、フックスクリプトを削除します。

Herdr は保存された Kimi セッションを kimi --session <id> で resume します。

Droid

Droid フックをインストールします:

herdr integration install droid

Droid フックは、他のインテグレーションと同じローカルソケット API を通じてセッション識別を報告します。Droid のフックはすべてのライフサイクル遷移をカバーしていないため、ライフサイクル状態は引き続き Herdr のスクリーンマニフェスト検出から得られます。

Herdr は Droid フックに ~/.factory を使います。Factory の設定ディレクトリはあらかじめ存在している必要があります。インストールは hooks/herdr-agent-state.sh を書き込み、settings.json に Herdr の SessionStart フックエントリを追加し、hooks.json に古い Herdr Droid フックエントリがあれば削除します。アンインストールは両方の設定ファイルから Herdr のエントリを削除し、フックスクリプトを削除します。

Droid がセッション開始イベントを発行した後、Herdr は報告されたセッション id を使って droid --resume <id> でペインを resume できます。

OpenCode

OpenCode プラグインをインストールします:

herdr integration install opencode

この連携は OpenCode V1 1.18.29 以降と OpenCode V2（beta 19242 で検証済み）に対応します。OpenCode の設定ディレクトリはあらかじめ存在している必要があります。Herdr はサーバー側のエントリポイントを ~/.config/opencode/plugins/herdr-agent-state.js に、共通 TUI プラグインを同じ設定ディレクトリの herdr-tui-session.js に、V2 TUI エントリポイントを herdr-opencode/tui.js にインストールします。

インストール時、V1 TUI プラグインを tui.jsonc に、V2 TUI プラグインを cli.json に登録し、他の設定やプラグインは保持します。tui.json に既存の V1 登録がある場合もインストール済みとみなし、tui.jsonc を作成せずに再利用します。アンインストールでは、両方の TUI 設定ファイルから Herdr の登録を削除し、ファイルと他の設定は保持します。OpenCode に移行すべき V1 TUI 設定（tui.json または kv.json）が残っている場合、Herdr は初回起動時の移行を妨げないよう登録を見送ります。その場合は一度 opencode2 を起動してから連携を再インストールしてください。それ以外の場合は Herdr が cli.json を作成してプラグインを登録します。インストール後は OpenCode TUI を再起動してください。アンインストールは管理対象のプラグインファイルと設定項目を削除します。

V2 のライフサイクル報告はペイン内の TUI で実行され、複数のペインが同じ OpenCode サーバーを共有する場合も、選択されたルートセッションにイベントを対応付けます。完了時または中断時に working 状態を解除し、未処理の権限要求やフォーム、実行失敗は blocked 状態を維持します。V2 Mini とヘッドレスクライアントは TUI プラグインを実行しないため、このライフサイクル報告は利用できません。

V1 TUI はペインで選択したセッションとその子孫を追跡します。いずれかが実行中・再試行中なら working、権限要求や質問が未処理なら blocked を維持します。接続時に既存の状態を読み込み、キャンセル済みツールの要求が再接続後に blocked を復活させることはありません。サブエージェントの閲覧では元のセッション群を維持し、子セッションへ直接接続した場合は兄弟ではなくその子孫だけを追跡します。

ローカル V1 の opencode run と opencode --mini は従来のサーバーフックを維持します。この変更は Mini やヘッドレスクライアントにペイン固有のライフサイクル報告を追加するものではありません。連携の更新後は TUI と共有 OpenCode サーバーの両方を再起動し、古いサーバー報告がペインの状態を上書きしないようにしてください。

このプラグインは、OpenCode が Herdr のペイン内で動いている間、ライフサイクル状態とセッション識別を報告します。OpenCode がセッション情報を含むイベントを発行した後、Herdr は報告されたセッション id を使って opencode --session <id> でペインを resume できます。プラグインがインストールされていないときは、スクリーンマニフェスト検出が引き続き利用できます。

Kilo Code CLI

Kilo Code CLI プラグインをインストールします:

herdr integration install kilo

Herdr はプラグインを ~/.config/kilo/plugin/herdr-agent-state.js に書き込みます。Kilo の設定ディレクトリはあらかじめ存在している必要があります。アンインストールはそのプラグインファイルだけを削除します。

このプラグインは、Kilo が Herdr のペイン内で動いている間、ライフサイクル状態とセッション識別を報告します。Kilo がセッション情報を含むイベントを発行した後、Herdr は報告されたセッション id を使って kilo --session <id> でペインを resume できます。プラグインがインストールされていないときは、スクリーンマニフェスト検出が引き続き利用できます。

Hermes Agent

Hermes Agent プラグインをインストールします:

herdr integration install hermes

Herdr は Hermes ホームディレクトリ内の plugins/herdr-agent-state/ に書き込み、その config.yaml で herdr-agent-state を有効にします。HERMES_HOME のデフォルトは Unix では ~/.hermes、Windows では %LOCALAPPDATA%\hermes です。Hermes の設定ディレクトリはあらかじめ存在している必要があります。プラグインを読み込ませるため、インストール後に Hermes を再起動してください。アンインストールはプラグインディレクトリを削除し、plugins.enabled から herdr-agent-state を削除します。

このプラグインは、Hermes が Herdr のペイン内で動いている間、resume 可能なセッション id を報告します。Herdr は working、idle、blocked にスクリーンマニフェスト検出を使い、報告されたセッション id で hermes --resume <id> としてペインを resume できます。

Qoder CLI

Qoder CLI フックをインストールします:

herdr integration install qodercli

このフックは、ネイティブ復元のために Qoder CLI のセッション識別を Herdr に報告します。Qoder のフックはすべてのライフサイクル遷移をカバーしていないため、ライフサイクル状態は引き続き Herdr のスクリーンマニフェスト検出から得られます。

Herdr はデフォルトで ~/.qoder を使い、QODER_CONFIG_DIR が設定されていればそちらを使います。Qoder の設定ディレクトリはあらかじめ存在している必要があります。インストールは hooks/herdr-agent-state.sh を書き込み、settings.json に Herdr のフックエントリを追加します。アンインストールは一致するフックエントリを削除し、フックスクリプトを削除します。

Herdr は保存された Qoder CLI セッションを qodercli --resume <id> で resume します。

フックがインストールされていないときは、スクリーンマニフェスト検出が引き続き利用できます。

Qwen Code

Qwen Code フックをインストールします:

herdr integration install qwen

SessionStart フックはネイティブ復元用のセッション識別だけを報告します。ライフサイクル状態は引き続き Herdr のスクリーンマニフェスト検出が決定します。

Herdr はデフォルトで ~/.qwen を使い、QWEN_HOME が設定されていればそちらを使います。Qwen の設定ディレクトリはあらかじめ存在している必要があります。インストールは hooks/herdr-agent-session.sh（Windows では hooks/herdr-agent-session.ps1）を書き込み、settings.json に Herdr エントリを追加します。アンインストールは一致するエントリと管理対象スクリプトだけを削除します。

Herdr は保存された Qwen Code セッションを qwen --resume <id> で resume します。

Letta Code

Letta Code インテグレーションのインストールは実験的な CLI 専用機能です。Settings のインテグレーション一覧や JSON インテグレーション API には含まれません。herdr integration status では letta (experimental) と表示されます。エージェント検出と herdr agent start --kind letta は、このインストール方法の制限とは別にサポートされています。

Letta Code フックをインストールします:

herdr integration install letta

静かな SessionStart フックは、ネイティブ復元用の会話 ID を報告します。Letta Code の状態は引き続き Herdr のスクリーンマニフェスト検出から得られます。

Herdr は ~/.letta を使います。設定ディレクトリはあらかじめ存在している必要があります。インストールは hooks/herdr-agent-session.sh（Windows では hooks/herdr-agent-session.ps1）を書き込み、settings.json に Herdr エントリを追加します。アンインストールは一致するエントリと管理対象スクリプトだけを削除します。

Herdr は名前付き会話を letta --conversation <id> で resume します。デフォルト会話は default:<agent-id> として記録し、letta --conversation default --agent <agent-id> で resume します。

Cursor Agent CLI

Cursor Agent CLI フックをインストールします:

herdr integration install cursor

このフックは、Cursor Agent CLI が Herdr のペイン内で動いている間、Cursor の sessionStart フックを通じてセッション識別を報告します。Cursor の状態は Herdr のスクリーンマニフェスト検出から得られます。

Herdr はデフォルトで ~/.cursor を使い、CURSOR_CONFIG_DIR が設定されていればそちらを使います。Cursor の設定ディレクトリはあらかじめ存在している必要があります。インストールは herdr-agent-state.sh（Windows では herdr-agent-state.ps1）を書き込み、hooks.json に Herdr の sessionStart エントリを追加します。アンインストールは一致するフックエントリを削除し、フックスクリプトを削除します。

Cursor がセッション開始イベントを発行した後、Herdr は報告されたセッション id を使って cursor-agent --resume <id> でペインを resume できます。Herdr がペインを復元するとき、cursor-agent コマンドが PATH にある必要があります。Herdr は汎用の agent コマンドを起動しません。

MastraCode

MastraCode フックをインストールします:

herdr integration install mastracode

このフックは、MastraCode のライフサイクル状態とスレッド識別を Herdr に報告し、権威ある idle、working、blocked 状態とネイティブ復元を提供します。MastraCode にはスクリーンマニフェストのフォールバックはありません。MastraCode が Herdr ペイン内で動いている間、状態はフックから得られます。

Herdr は ~/.mastracode を使います。インストールは hooks/herdr-agent-state.sh（Windows では hooks/herdr-agent-state.ps1）を書き込み、hooks.json に Herdr のコマンドエントリを追加します。ディレクトリがなければ作成します。アンインストールは一致するフックエントリを削除し、フックスクリプトを削除します。

Herdr は保存された MastraCode スレッドを mastracode --thread <id> で resume します。

Antigravity CLI

Antigravity CLI フックをインストールします:

herdr integration install antigravity-cli

Herdr はデフォルトで ~/.gemini/config/ を使い、ANTIGRAVITY_CLI_CONFIG_DIR が設定されていればそちらを使います。これは Antigravity CLI がグローバルカスタマイズを読み込むディレクトリで、あらかじめ存在している必要があります。インストールは hooks/herdr-agent-state.sh（Windows では herdr-agent-state.ps1）を書き込み、hooks.json に Herdr 所有の herdr ブロックを追加します。Antigravity CLI は hooks.json をフック名で管理するため、インストールはそのブロックだけを書き換え、ほかの名前付きフックには触れません。アンインストールは herdr ブロックとフックスクリプトを削除します。

このインテグレーションはセッション専用です。ペインで実行中の会話を報告しますが、エージェント状態は報告しません。そのため、Herdr は Antigravity CLI の画面表示から working、idle、blocked を引き続き判定します。

フックは PreInvocation で実行されるため、最初のプロンプト送信後に Herdr が会話を認識します。それ以降、Herdr サーバーの再起動後に agy --conversation <id> でペインを resume できます。

Grok CLI

Grok CLI フックをインストールします:

herdr integration install grok

このフックは、Grok CLI が Herdr のペイン内で動いている間、Grok の SessionStart フックを通じてセッション識別を報告します。Grok の状態は Herdr のスクリーンマニフェスト検出から得られます。

Herdr はデフォルトで ~/.grok を使い、GROK_HOME が設定されていればそちらを使います。Grok の設定ディレクトリはあらかじめ存在している必要があります。Grok はそのディレクトリ内のすべての hooks/*.json ファイルを統合するため、インストールは Herdr の SessionStart エントリだけを含む hooks/herdr.json と hooks/herdr-agent-state.sh（Windows では hooks/herdr-agent-state.ps1）を書き込み、ほかのフックファイルには触れません。アンインストールは Herdr 所有のこの 2 ファイルだけを削除します。

Grok がセッション開始イベントを発行した後、Herdr は報告されたセッション id を使って grok --resume <id> でペインを resume できます。

カスタムステータスラベル

インテグレーションは、ライフサイクル状態を意味的な状態としてのみ報告します。たとえば、ライフサイクル報告に表示フィールドを加えず、エージェントを working として報告します。

herdr pane report-agent w1:p1 \
  --source custom:docs \
  --agent docs-bot \
  --state working

Herdr 管理のインテグレーションと並走するユーザーフックは、report-agent ではなくメタデータを使うべきです。メタデータは、インテグレーションの idle、working、blocked やセッション復元の権威を奪わずに表示を変えます。--agent と --applies-to-source は表示フィールド (--title、--display-agent、--state-label) だけを保護します。トークンパッチは常に適用され、クリアまたは TTL の更新は報告側が管理します。--display-agent は表示名を変更します。

herdr pane report-metadata "$HERDR_PANE_ID" \
  --source user:claude-title \
  --agent claude \
  --title "Refactor auth middleware" \
  --display-agent "Claude: auth" \
  --token summary="refactor auth" \
  --state-label working="refactoring auth" \
  --ttl-ms 3600000

トークンと状態ラベルは表示専用です。wait、通知、ワークスペースのロールアップは引き続き意味的な状態を使います。

インテグレーション状態のデバッグ

既知のエージェントを一覧します:

herdr agent list

Herdr に何が見えているか確認する必要があるときはペインを読みます:

herdr pane read w1:p1 --source recent --lines 50

インテグレーションの状態がおかしく見えるときは、まずエージェントが Herdr 内で動いていること、そして該当のフックまたはプラグインが同じユーザーアカウントにインストールされていることを確認してください。