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

インテグレーション

Preview docs describe unreleased preview builds. Stable docs remain at /docs/.

Nagi は対応エージェントを自動的に検出します。公式インテグレーションは、復元のためのネイティブセッション識別、ライフサイクル状態の報告、またはその両方を追加できます。

Claude Code/Codex/Copilot/Devin 系のフックによるエージェントネイティブのセッション復元、Pi/OMP/Kimi/OpenCode/Kilo/Hermes/MastraCode 系のフックまたはプラグインによる直接のライフサイクル報告、あるいはその両方が欲しいときにインテグレーションを使ってください。状態権威モデルの全体像はエージェントを参照してください。

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

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

nagi integration install pi
nagi integration install omp
nagi integration install claude
nagi integration install codex
nagi integration install copilot
nagi integration install devin
nagi integration install droid
nagi integration install kimi
nagi integration install opencode
nagi integration install kilo
nagi integration install hermes
nagi integration install mastracode
nagi integration install qodercli
nagi integration install cursor

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

nagi integration uninstall pi
nagi integration uninstall omp
nagi integration uninstall claude
nagi integration uninstall codex
nagi integration uninstall copilot
nagi integration uninstall devin
nagi integration uninstall droid
nagi integration uninstall kimi
nagi integration uninstall opencode
nagi integration uninstall kilo
nagi integration uninstall hermes
nagi integration uninstall mastracode
nagi integration uninstall qodercli
nagi integration uninstall cursor

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

Nagi はインテグレーションを 2 つの異なる方法で使います:

インテグレーションの種類	エージェント	効果
ライフサイクル権威	Pi、OMP、Kimi Code CLI、OpenCode、Kilo Code CLI、Hermes Agent、MastraCode	インストールされ、そのペインについて能動的に報告している間は、フックまたはプラグインのイベントが `idle`、`working`、`blocked` を決定します。同じライフサイクル権威に対して、Nagi はスクリーンマニフェストのフォールバックを併用しません。
セッション識別	Claude Code、Codex、GitHub Copilot CLI、Devin CLI、Droid、Qoder CLI、Cursor Agent CLI	インテグレーションは復元用のネイティブセッション参照を報告します。状態は引き続き Nagi のスクリーンマニフェスト検出から得られます。

カスタムソケットインテグレーションも、ネイティブのターミナル UI では見えない状態を定義する場合に状態を報告できます。

一部のインテグレーションは、エージェントのネイティブセッション参照を報告します。Nagi は公式のセッション参照を使って、[session] resume_agents_on_restore = false で無効化されていない限り、Nagi サーバーの再起動後に Claude Code、Codex、Devin CLI、Droid、Kimi Code CLI、Qoder CLI、Cursor Agent CLI、GitHub Copilot CLI、Pi、OMP、Hermes Agent、OpenCode、Kilo Code CLI、MastraCode のペインを resume します。

エージェントネイティブのセッション復元には最新の Nagi インテグレーションが必要です: 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、Cursor Agent CLI は 1、OpenCode は 5、Kilo Code CLI は 1、Hermes Agent は 2、MastraCode は 1 です。インストール済みバージョンは nagi integration status で確認してください。

Pi

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

nagi integration install pi

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

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

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

OMP

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

nagi integration install omp

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

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

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

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

Claude Code

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

nagi integration install claude

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

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

Codex

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

nagi integration install codex

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

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

GitHub Copilot CLI

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

nagi integration install copilot

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

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

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

Devin CLI

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

nagi integration install devin

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

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

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

Kimi Code CLI

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

nagi integration install kimi

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

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

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

Droid

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

nagi integration install droid

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

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

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

OpenCode

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

nagi integration install opencode

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

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

Kilo Code CLI

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

nagi integration install kilo

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

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

Hermes Agent

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

nagi integration install hermes

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

このプラグインは、Hermes が Nagi のペイン内で動いている間、ライフサイクル、ツール、承認状態、セッション id を報告します。Nagi は報告されたセッション id を使って hermes --resume <id> でペインを resume できます。プラグインがインストールされていないときは、スクリーンマニフェスト検出が引き続き利用できます。

Qoder CLI

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

nagi integration install qodercli

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

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

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

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

Cursor Agent CLI

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

nagi integration install cursor

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

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

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

MastraCode

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

nagi integration install mastracode

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

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

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

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

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

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

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

nagi pane report-metadata "$NAGI_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、通知、ワークスペースのロールアップは引き続き意味的な状態を使います。

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

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

nagi agent list

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

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

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