コンテンツにスキップ
Zanei
日本語
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

セットアップ

native 連携または手動配置用に表示される指示で、agent に Zanei を設定する。

Zanei が持つ agent 向け指示の単一ソースは、標準形式の skills/SKILL.md だけです。zanei setup は CLI を実行する agent すべてにそのまま配置します。MCP については各 agent 向けの登録コマンドを表示し、設定ファイルへ直接書き込むのは Claude Desktop のみです。opencode の MCP JSON は手動設定用に表示します。

zanei setup --agent <claude|codex|opencode|hermes|pi|claude-desktop> [--scope project|user] [--print]

各フラグの意味は setup CLI リファレンスを参照してください。

agent 別セットアップ

zanei setup --agent claude

単一ソースの SKILL.md を変更せずに Claude Code が skill を発見する位置へ配置し、実行すべき MCP 登録コマンドを表示します。

claude mcp add zanei -- zanei mcp

Claude Code は project scope では .claude/skills/zanei/SKILL.md、user scope では ~/.claude/skills/zanei/SKILL.md に配置します。

zanei setup --agent codex

単一ソースの SKILL.md を変更せずに ~/.codex/skills/zanei/SKILL.md へ配置し、実行すべき MCP 登録コマンドを表示します。

codex mcp add zanei -- zanei mcp

または Codex の config.toml に次を追加します。

[mcp_servers.zanei]
command = "zanei"
args = ["mcp"]

Codex の skill と MCP 登録はユーザーグローバルのため、--scope にかかわらず常に ~/.codex/ 配下を対象にします。

zanei setup --agent opencode

opencode は Agent Skills を native に読み込むため、このコマンドは単一ソースの SKILL.md をそのまま配置します。

$XDG_CONFIG_HOME/opencode/skills/zanei/SKILL.md    # --scope user
.opencode/skills/zanei/SKILL.md                    # --scope project

XDG_CONFIG_HOME が未設定なら ~/.config にフォールバックします。opencode 自身の探索と同じ挙動です。

MCP は手動のままです。opencode mcp add が対話ウィザードで、非対話用のフラグを持たないためです。以下のエントリを opencode.json に追加してください。

{
  "mcp": {
    "zanei": { "type": "local", "command": ["zanei", "mcp"] }
  }
}
zanei setup --agent hermes

Hermes Agent は skill と MCP を両方第一級で持ち、どちらも ~/.hermes/ 配下のユーザーグローバル設定です。setup は単一ソースの SKILL.md を変更せずに ~/.hermes/skills/zanei/SKILL.md へ配置し、実行すべき MCP 登録コマンドを表示します。

hermes mcp add zanei --command zanei --args mcp

または ~/.hermes/config.yaml に次を追加します。

mcp_servers:
  zanei:
    command: "zanei"
    args: ["mcp"]

Hermes Agent の設定はユーザーグローバルのため、--scope project はここでは適用されず、setup は常に ~/.hermes/ を対象にします。

zanei setup --agent claude-desktop

Claude Desktop の chat は Mac 上で zanei を実行できないため、MCP が接続経路です。claude_desktop_config.json にサーバを登録します。

{
  "mcpServers": {
    "zanei": {
      "command": "zanei",
      "args": ["mcp"]
    }
  }
}

対象は chat の面だけです。同じアプリ内で動く Claude Code には zanei setup --agent claude を実行してください。

Claude Desktop の setup は --scope にかかわらず、常に claude_desktop_config.json を対象にします。

zanei setup --agent pi

pi は Agent Skills を native に読み込むため、このコマンドは単一ソースの SKILL.md をそのまま配置します。

~/.pi/agent/skills/zanei/SKILL.md    # --scope user
.pi/skills/zanei/SKILL.md            # --scope project

pi は設計方針として MCP を持たないため、zanei mcp は登録されず、skill が唯一の経路です。

ここに載っていない MCP 対応 agent では、クライアント標準の MCP 設定で zanei mcp を stdio サーバとして登録してください。JSON の形は Claude Desktop のスニペットと同じです。

動作確認

  1. zanei status で記録が動いていることを確認します(agent 自身も get_status で確認できます)。
  2. agent に 「直近 1 時間で何をしていたか確認して」 のように聞いてみます。
  3. agent が get_timeline(MCP)または zanei timeline(CLI)を呼び、実際の行動履歴から答えれば成功です。

agent が「記録が動いていない」と報告した場合は zanei start を実行します。終了コード 3 なら recorder は起動済みですが権限が必要です。表示された手順で付与し、zanei stop && zanei start してから zanei doctor で確認してください(権限ガイド)。

このページは役に立ちましたか?