エージェントを接続する

AWRはあなたのエージェントを実行しません。エージェントクライアント（Codex、Claude Code、Kimi、Cursor、 Grok）が自分のツールで作業を行い、AWRは同じ初期化済みプロジェクトについて、現在のプロジェクトの事実、作業コンテキスト、クレーム、リカバリー可能なセッションメモリを供給します。AWRのセッション記録にあるプロバイダーとモデルのラベルはメタデータにすぎません —— クライアントを起動したり設定したりすることは決してありません。

サポートされるすべてのクライアントは同じパターンに従います:

AWRのチェックアウトから両方の実行ファイルをビルドします:

cargo build --locked -p awr-cli -p awr-mcp

レビュー済みのソースマニフェストから対象プロジェクトを初期化し（クイックスタート参照）、クライアントにawr-mcpサーバーを登録します。--projectにはプロジェクトの絶対パスを指定します。各サーバーは1つの正規プロジェクトルートにバインドします。異なるプロジェクトのサーバーには別々の名前を付けてください。
接続を検証します —— ディスク上の設定ファイルはライブ接続ではありません —— そして作業前にステータス読み取りでプロジェクトの識別情報を確認します。
共有セッションライフサイクルを回します: セッションを開始または再開し、コンテキストを読み、ハンドオフ前にチェックポイントを取り、停止時に終了します。CLIとMCPツールを参照してください。

以下のセクションでは、各クライアントのマージパス、設定、注意点を示します。クライアントが自動ライフサイクルフックを文書化している場合でも、実際のトリガーと領収書を確認するまでは未検証として扱ってください。手動のチェックポイント/再開フローは常に機能します。

Codex

Codexは信頼されたプロジェクトのプロジェクト設定のみを読み込みます。そのCLI、デスクトップ、IDE クライアントは同じホスト上でMCP設定を共有します。2つの選択肢から1つを選んでください。MCP設定テンプレートをプロジェクトの.codex/config.tomlにマージする（2つのパスを置き換え、既存の設定を保持する）か、ユーザーレベルで登録します:

codex mcp add awr -- /absolute/path/to/awr-mcp \
  --project /absolute/path/to/initialized/project
codex mcp get awr --json

クライアントの/mcpビューで、接続済みのawrサーバーを確認し、作業前にプロジェクトの識別情報を検証してください。設定されたサーバーはアクティブな接続の証明ではありません。期待される読み取りツール: awr_project_status、awr_work_ready、awr_work_get、awr_context_compile、awr_search。変更ツール: awr_work_transition、awr_event_append、awr_evidence_record。サーバーはモデルの APIキーを必要としません。

Codexは、自動ライフサイクルフックのインストーラーを持つ唯一のクライアントです。--acceptの前に awr client installで正確な設定をプレビューしてください。インストールは既存のフックを保持し、その信頼を自動的に承認することは決してありません。CodexはSessionStart（startup|resume|clear|compact）、 PreCompact（manual|auto）、SessionEnd（参考情報、短いタイムアウト）を文書化しています。クライアントで実際のトリガー配信を検証してください —— それまでは、ハンドオフやコンパクションの前に手動でチェックポイントを取ってください。

Claude Code

Claude Codeは名前付きの制御アダプター（アダプターID claude_code）を通じて接続します。自動起動はできません。AWRはClaude Codeを起動しませんし、独自に停止することもありません —— それらのステップはあなたに残ります。アダプターがサポートするのは、ステータスの読み取り、再接続/再開、結果のフォレンジックです。

運用者の手順:

Claude Codeを自分で起動します。
汎用クライアントとネイティブ会話IDでAWRにバインドします:

awrj client bind --client generic --external-session claude:<native-id> \
  --work "$AWR_WORK" --session "$AWR_SESSION"

AWRの観察が必要なときは、共有CLIの外部実行レポートを通じてフェーズを報告します。
再試行時は、新しいことを始める前に同じ実行識別情報を再接続します。

Kimi

このガイドはKimi Code 0.41.0（2026-09-08に検査）を対象としています。古いkimi-cliリリースは異なる設定パスとフラグを使うため、まずkimi --versionとkimi --helpを確認してください。Kimiのターミナルツールで AWR CLIを呼び出し、任意で、以下のサーバーをプロジェクトの.kimi-code/mcp.json（ユーザーレベル: ~/.kimi-code/mcp.json）にマージして、同じプロジェクトをstdio MCP経由で接続します。他のエントリーは保持してください:

{
  "mcpServers": {
    "awr": { "command": "/absolute/path/to/awr-mcp",
      "args": ["--project", "/absolute/path/to/initialized/project"],
      "cwd": "/absolute/path/to/initialized/project" }
  }
}

プロジェクト設定にはワークスペースの信頼が必要です。設定には/mcp-configを、接続状態の確認には/mcpを使います。設定の編集で追加されたサーバーは、新しく作成されたセッションに参加します。 awr_project_statusでプロジェクトの識別情報を確認してください。Kimiセッションメタデータのプロバイダーラベルはmoonshotです。

Kimi自身のkimi --continue、kimi --session <kimi-conversation-id>、/compactはその会話に作用します。それらのIDはAWRのIDとは別物です。コンパクト後は、同じアクティブなAWRセッションのコンテキストをコンパイルしてください —— 明示的なAWR再開は実際のハンドオフのためだけのものです。KimiはSessionStart、 SessionEnd、PreCompact、PostCompactフックを文書化していますが、この統合は自動アダプターをインストールしません。手動のチェックポイントプロセスを使ってください。

Cursor

Cursor 3.18.9（2026-09-17）で確認済み。Cursorに対してawr client installを実行しないでください（Unsupported）。また、bindに--client cursorを渡さないでください（InvalidInput） —— 以下に示す汎用クライアント識別情報を使ってください。stdioテンプレートをプロジェクトの.cursor/mcp.jsonまたはユーザーの~/.cursor/mcp.jsonにマージします:

{
  "mcpServers": {
    "awr": { "type": "stdio", "command": "/absolute/path/to/awr-mcp",
      "args": ["--project", "/absolute/path/to/initialized/project"] }
  }
}

Cursorのstdioフィールドテーブルは"type": "stdio"を必須とし、cwdを受け付けません。AWRが必要とするのは絶対パスのcommandと--projectだけです。起動に失敗したらウィンドウを再読み込みし、Output → MCP Logs を確認してください。両方の設定ファイルが存在する場合は、CustomizeでAgent Windowがどちらにアタッチしたかを確認してください。2つの注意点:

グループ化ツール。 現在のソースツリーでは、デフォルトのtools/listはフラットなツール名ではなく8つのドメインツール（awr_query、awr_context、awr_work、awr_evidence、awr_session、awr_continuity、 awr_change、awr_compaction）を返します。awr_query経由でステータスを調べます:

{"child_tool": "awr_project_status", "arguments": {}}

フラットな名前は引き続き呼び出せますが、デフォルトのカタログには含まれません。お使いのCursorビルドがドメイン経由でルーティングできない場合のみAWR_MCP_TOOL_EXPOSURE_MODE=flatを設定してください。パッケージリリースはグループ化されたawr_queryを公開しません —— この経路はソースツリーからビルドし、まずお使いのビルドのツールカタログを確認してください。

Cloud Agentsはラップトップのawr-mcpや127.0.0.1に到達できません。サーバー側のプロジェクトルートを持つ到達可能なHTTPSの入口が必要です。AWRの共有HTTPサービスはベアラートークンを使います（Cursor OAuthではありません）:

{
  "mcpServers": {
    "awr": { "url": "http://127.0.0.1:8080/mcp",
      "headers": { "Authorization": "Bearer ${env:AWR_ENGINEERING_TOKEN}" } }
  }
}

識別情報としては、ネイティブ会話IDで汎用クライアントをバインドします。空の場合は失敗させ、リテラルの cursor:をバインドしないようにします:

: "${HOST_CONVERSATION_ID:?set the native host conversation ID first}"
AWR_EXTERNAL="cursor:${HOST_CONVERSATION_ID}"
awrj client bind --client generic --external-session "$AWR_EXTERNAL" \
  --work "$AWR_WORK" --session "$AWR_SESSION"

Cursorは.cursor/hooks.jsonにsessionStart、sessionEnd、preCompactフックを文書化していますが、その方言用のインストーラーはありません —— 実際に動くフックトリガーとチェックポイントの領収書を得るまで、手動でチェックポイントを取ってください。

Grok

Grok Build 1.0.13（2026-09-08）で確認済み。GrokのターミナルツールでAWR CLIを呼び出すか、プロジェクトディレクトリからstdio MCPクライアントを接続します:

cd /absolute/path/to/initialized/project
grok mcp add --scope project awr -- /absolute/path/to/awr-mcp \
  --project /absolute/path/to/initialized/project
grok mcp doctor awr --json

add --scope projectは.grok/config.tomlを書き込みまたは更新します（フラグ省略時はユーザースコープがデフォルト）。awrがすでに別のプロジェクトを指している場合は、別のサーバー名を使ってください。同等のテーブルは次の通りです:

[mcp_servers.awr]
command = "/absolute/path/to/awr-mcp"
args = ["--project", "/absolute/path/to/initialized/project"]

Grok Buildで/mcpsを使って接続を検査・更新し、awr_project_statusを呼び出してプロジェクトの識別情報を検証してください。プロジェクトの信頼は別の前提条件です。信頼されていないフォルダーはサーバーを起動しないままにするため、まずクライアントの通常の信頼ワークフローでプロジェクトをレビューしてください。Grokセッションメタデータのプロバイダーラベルはxaiです。

Grokのネイティブの会話継続はAWRのセッションリカバリーとは別物です:

grok --cwd "$AWR_PROJECT" --continue
grok --cwd "$AWR_PROJECT" --resume <grok-conversation-id>

Grokの--session-idは新しい会話を作成します —— AWRのIDでも再開フラグでもありません。ネイティブのコンパクション後は、同じアクティブなAWRセッションのコンテキストをコンパイルしてください。明示的なAWR再開フローは実際のハンドオフのためだけに使います。

Grok Buildはフックシステムでセッションとコンパクトのイベントを文書化していますが、ここでは自動アダプターはインストールされません。実際のトリガーと領収書を検証するまで、手動のチェックポイントプロセスを使ってください。Grok webのカスタムコネクターは到達可能なMCP URLを必要とします —— ローカルの実行ファイルパスはそのURLとして入力できません。AWRの共有HTTPサービスがその役割を果たせますが、それをデプロイしてコネクターの認証要件を満たすことは、このガイドが検証しない別のステップです。

次のステップ

MCPツール —— 接続後にクライアントが呼び出せるツールの全体像。
日常ワークフロー —— どのクライアントを使っても同じ、開始・作業・チェックポイント・再開のループ。