セットアップ
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 mcpClaude 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 opencodeopencode は Agent Skills を native に読み込むため、このコマンドは単一ソースの SKILL.md をそのまま配置します。
$XDG_CONFIG_HOME/opencode/skills/zanei/SKILL.md # --scope user
.opencode/skills/zanei/SKILL.md # --scope projectXDG_CONFIG_HOME が未設定なら ~/.config にフォールバックします。opencode 自身の探索と同じ挙動です。
MCP は手動のままです。opencode mcp add が対話ウィザードで、非対話用のフラグを持たないためです。以下のエントリを opencode.json に追加してください。
{
"mcp": {
"zanei": { "type": "local", "command": ["zanei", "mcp"] }
}
}zanei setup --agent hermesHermes 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-desktopClaude 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 pipi は Agent Skills を native に読み込むため、このコマンドは単一ソースの SKILL.md をそのまま配置します。
~/.pi/agent/skills/zanei/SKILL.md # --scope user
.pi/skills/zanei/SKILL.md # --scope projectpi は設計方針として MCP を持たないため、zanei mcp は登録されず、skill が唯一の経路です。
ここに載っていない MCP 対応 agent では、クライアント標準の MCP 設定で zanei mcp を stdio サーバとして登録してください。JSON の形は Claude Desktop のスニペットと同じです。
動作確認
zanei statusで記録が動いていることを確認します(agent 自身もget_statusで確認できます)。- agent に 「直近 1 時間で何をしていたか確認して」 のように聞いてみます。
- agent が
get_timeline(MCP)またはzanei timeline(CLI)を呼び、実際の行動履歴から答えれば成功です。
agent が「記録が動いていない」と報告した場合は zanei start を実行します。終了コード 3 なら recorder は起動済みですが権限が必要です。表示された手順で付与し、zanei stop && zanei start してから zanei doctor で確認してください(権限ガイド)。