Agent 連携

Zanei が AI agent とつながる仕組み — 2 つの面と skill 指示レイヤー、対応 agent、agent にできること・できないこと。

Zanei は、あなたが打ち込まなかった文脈 — 何を読んでいたか、どの PR をレビューしていたか、どこで中断したか — を agent に渡します。どの連携面も同じローカルストアの上のラッパーです。

2 つの面と、1 つの指示レイヤー

Zanei が履歴を露出する面は 2 つです — どちらも同じローカルストアの薄いラッパーです：

skill は第 3 の面ではなく、「いつ履歴を見るか」「トークンを抑える呼び方」を agent に伝える指示レイヤーです。指示の届き方は面ごとに異なります：

• MCP では指示は内在化されています。ツール名・説明・既定値・スキーマはプロトコル（tools/list）の中で配信されるため、MCP クライアントに追加の設定は不要です。Claude Desktop の setup がサーバ登録だけで済むのはこのためです。
• CLI は agent に対して自己記述的でないため、Zanei は単一の skills/SKILL.md を指示の正本として持ちます。setup は skill 対応 agent にはそのまま配置します。opencode と pi では AGENTS.md または README 向けの指示を導出して表示し、配置はユーザー自身が行います。各 agent はその指示を固有の方式で読み込みます。

対応 agent

setup は skill を配置し、agent 向けの MCP 登録コマンドと、opencode / pi に必要な手動設定用の指示を表示します — セットアップ参照。

agent にできること

MCP 経由では 3 つの read-only ツールが使えます（詳細は MCP リファレンス）：

• get_timeline — LLM-ready タイムライン。zanei timeline と等価。agent が最もよく呼ぶツール。
• query_events — 生イベント検索。zanei query と等価。
• get_status — 記録が動いているか・権限は大丈夫か。running が false のとき、良い agent は「履歴は現在記録されていない」とユーザーに伝えられます。

CLI 経由なら（あなたの承認フローの下で）記録の開始・停止を含むすべてが使えます。同梱の skill が教えるのは読み出し系・status / doctor の診断・「記録設定の変更はユーザーの明示的な依頼があったときだけ」という規律です。

agent にできないこと

MCP サーバは記録デーモンとは独立したプロセスで動く、ストアへの読み取り専用ビューです：

• 記録の開始・停止はできません。
• 設定の変更はできません。capture-time フィルタも含みます。agent が MCP 経由で記録対象を広げることはできません。

データの流れについて

Zanei 自体はデータをどこにも送りません。タイムラインを読んだ agent は通常それを LLM プロバイダへ転送します。そのホップは agent の管轄です。同梱の skill は、数日分を引くのではなく送信前に範囲を絞る（例：--since 2h、token budget 4000）よう agent に指示しています。