multi-agent-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@multi-agent-mcp init tmux workspace for /project/foo with session bug-123"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Multi-Agent MCP
AI CLI(Claude Code / Codex / Antigravity (agy) / Cursor)+ tmux + git worktree (または非gitディレクトリ)を使用したマルチエージェントワークフローの MCP サーバー。
概要
このMCPサーバーは、複数のAI CLIインスタンスを tmux セッションで管理し、並列作業を実現します。
MCP_ENABLE_GIT=false を設定すると、git 管理されていないディレクトリでも実行できます。
Gitモード
モード | 設定 | 挙動 |
Git有効(デフォルト) |
| git リポジトリ前提。worktree/gtr 機能を利用可能 |
Git無効 |
| 非gitディレクトリで実行可能。git/worktree/gtr 機能は無効 |
init_tmux_workspace(enable_git=...) を指定すると、.multi-agent-mcp/config.json に保存され、
以降の同一プロジェクト実行で参照されます。
階層構造
Owner (1体): 全体指揮、タスク分解、Issue作成
Admin (1体): Worker管理、進捗管理、ダッシュボード更新
Worker (標準6体 / 最大16体): 割り当てられたタスクの実行
対応 AI CLI 一覧
CLI | 識別子 | 備考 |
Claude Code |
| デフォルト構成で利用可能 |
Codex |
| デフォルト構成で利用可能 |
Antigravity (agy) |
| デフォルト構成で利用可能。事前に端末CLIのセットアップが必要(後述) |
Cursor |
| 既定コマンドは |
agy(Antigravity CLI)のセットアップ
agy は Gemini CLI の後継となる Antigravity の端末 CLI 版です。利用前に以下を行ってください。
インストール
curl -fsSL https://antigravity.google/cli/install.sh | bashデスクトップアプリとの PATH 衝突に注意
Antigravity デスクトップアプリをインストール済みの環境では、アプリ同梱の agy が
PATH 上で先に解決されることがあります。端末 CLI 版を優先させるには、
インストール先(通常 ~/.local/bin)を PATH の先頭に追加するか、
シェルの rc ファイルでエイリアスを設定してください。
# 例: ~/.zshrc / ~/.bashrc
export PATH="$HOME/.local/bin:$PATH"サインイン
引数なしで agy を起動するとサインインフローが開始されます。
agyサインインが完了すれば、ai_cli="agy" で Admin/Worker から利用できます。
eligibility 要件
agy でエージェントを起動するには、Antigravity の利用資格を満たす Google アカウントが必要です。
一部の Google Workspace アカウントではサインインに成功しても
agy --print 実行時に Eligibility check failed: ... not eligible for Antigravity
のエラーで起動できないことがあります。この場合は個人の Google アカウントを使うか、
Workspace 管理者に Antigravity の利用有効化を依頼してください。
実起動確認手順(手動)
eligibility が解決したアカウントで、実際にセッションが継続することを手動確認してください
(本プロジェクトのテストコードでは agy の実起動検証は行っていません)。
小規模構成(Admin + Worker 1)で
ai_cli="agy"を指定してワークスペースを起動する。tmux ペイン内で agy が
--prompt-interactiveにより起動直後の応答だけで終了せず、 セッションを継続していることを確認する。Admin/Worker 間で IPC メッセージを送信し、ペインに
[IPC] 新しいメッセージの通知が 表示され、agy がそれに反応して作業を再開することを確認する(ワンショット終了しないこと)。
Related MCP server: Claude Team MCP Server
必要条件
Python 3.10以上
tmux
uv(推奨)または pip
最短セットアップ
MCP クライアントに
multi-agent-mcpを登録します。 Claude / Codex は次の CLI 例を使い、Antigravity (agy) / Cursor などで CLI サブコマンドが異なる場合は この後の JSON 設定例と同じcommand=uvx/args=[...]を登録してください。クライアントを再起動し、MCP サーバーへ再接続します。
クライアント上で
init_tmux_workspace("/path/to/project", session_id="issue-123")を実行して ワークスペースを初期化します。非 git ディレクトリではenable_git=falseを指定します。
インストール
GitHub から直接インストールできます(リポジトリの clone は不要)。
CLI で追加
通常運用では --reinstall なしを推奨します。
追加コマンドは次の「設定の追加・削除(再インストールとは別)」を参照してください。
設定の追加・削除(再インストールとは別)
Claude
# 追加(--reinstall なし)
claude mcp add --scope user multi-agent-mcp -- uvx --from git+https://github.com/shiiman/multi-agent-mcp multi-agent-mcp
# 削除
claude mcp remove multi-agent-mcpCodex
# 追加(--reinstall なし)
codex mcp add multi-agent-mcp -- uvx --from git+https://github.com/shiiman/multi-agent-mcp multi-agent-mcp
# 削除
codex mcp remove multi-agent-mcpAntigravity (agy) / Cursor など
CLI からの追加コマンドが未提供、または実装差分があるクライアントでは、 次の「設定ファイルに直接記述」の JSON 例と同じ内容を登録してください。
設定ファイルに直接記述
グローバル設定 (~/.claude.json):
{
"mcpServers": {
"multi-agent-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"--from", "git+https://github.com/shiiman/multi-agent-mcp",
"multi-agent-mcp"
]
}
}
}プロジェクト設定 (.mcp.json をプロジェクトルートに作成):
{
"mcpServers": {
"multi-agent-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"--from", "git+https://github.com/shiiman/multi-agent-mcp",
"multi-agent-mcp"
]
}
}
}自動更新について
--reinstall オプションを付けると、起動時に毎回 GitHub から最新版を再インストールします。
Note:
--refreshオプションでは Git リポジトリのキャッシュが効いたままになり、更新が反映されないことがあります。確実に最新版を使用するには--reinstallを推奨します。
--reinstall なし運用で更新したい場合は、次の「必要なときだけ再インストールする手順」を実行してください。
必要なときだけ再インストールする手順(Claude/Codex 共通):
# 1) 1回だけ再インストール(通常運用では毎回不要)
uv tool install --force --from git+https://github.com/shiiman/multi-agent-mcp multi-agent-mcp
# 2) 使用中のクライアントを再起動して MCP を再接続
# - Claude を使っている場合: Claude を再起動
# - Codex を使っている場合: Codex を再起動
# 3) 反映確認(使用クライアントに応じて実行)
claude mcp list
codex mcp get multi-agent-mcp
# 4) 反映されない場合のみキャッシュクリア
uv cache clean multi-agent-mcp上記の JSON 例は、mcpServers 形式を採用しているクライアントであれば
Claude / Codex 以外でも同様の考え方で利用できます。
設定の確認
# Claude
claude mcp list
# Codex
codex mcp list提供するTools(90個)
セッション管理(4個)
Tool | 説明 |
| ターミナルを開いてtmuxワークスペースを構築(Admin 1 + Worker 1-6 の7ペイン) |
| 全エージェントを終了しリソースを解放 |
| 全タスクの完了状態をチェック |
| 全タスク完了時にワークスペースをクリーンアップ |
エージェント管理(6個)
Tool | 説明 |
| 新しいエージェントを作成(tmuxセッション起動) |
| 全エージェントの一覧を取得 |
| 指定エージェントの詳細ステータスを取得 |
| エージェントを終了 |
| エージェントにロールテンプレートを渡してAI CLIを起動 |
| 複数のWorkerを並列で作成しタスクを割り当て |
コマンド実行(5個)
Tool | 説明 |
| エージェントにコマンドを送信 |
| エージェントのtmux出力を取得 |
| タスク指示をファイル経由でWorkerに送信 |
| エージェントのtmuxセッションをターミナルで開く |
| 全エージェント(または特定役割)にコマンド送信 |
Git Worktree管理(7個)
Tool | 説明 |
| 新しいgit worktreeを作成(git有効時のみ) |
| worktree一覧を取得(git有効時のみ) |
| worktreeを削除(git有効時のみ) |
| エージェントにworktreeを割り当て(git有効時のみ) |
| worktreeのgitステータスを取得(git有効時のみ) |
| gtr (git-worktree-runner) の利用可否を確認(git有効時のみ) |
| gtr aiでworktreeをAIツールで開く(git有効時のみ) |
create_worktree の引数契約
create_worktree は以下の引数契約です(branch_name 引数は存在しません)。
create_worktree(
repo_path="/path/to/repo",
worktree_path="/path/to/worktree",
branch="feature/xxx",
create_branch=True,
base_branch="main",
caller_agent_id="admin-or-owner-id",
)マージ(1個)
Tool | 説明 |
| 完了タスクの作業ブランチを commit なしで統合ブランチへ展開 |
IPC/メッセージング(5個)
Tool | 説明 |
| エージェント間でメッセージを送信 |
| エージェントのメッセージを読み取る |
| 未読メッセージ数を取得 |
| Owner の待機ロックを手動解除 |
| エージェントをIPCシステムに登録 |
ダッシュボード/タスク管理(15個)
Tool | 説明 |
| 新しいタスクを作成 |
| 終端タスクを再開(再実行用) |
| タスクのステータスを更新(Admin専用) |
| タスクをエージェントに割り当て(Admin専用) |
| タスク一覧を取得 |
| Workerがタスクの進捗を報告 |
| WorkerがAdminにタスク完了を報告(Worker専用) |
| タスクの詳細を取得 |
| タスクを削除 |
| ダッシュボード全体を取得 |
| ダッシュボードのサマリーを取得 |
| 現在のコスト推定を取得 |
| コスト警告の閾値を設定 |
| コストカウンターをリセット |
| コストサマリーを取得 |
create_task の metadata 運用
create_task では、タスク説明文字列だけでなく metadata を渡す運用を推奨します。
task_kind: タスク種別(例:implementation/qa/docs/report)requires_playwright: Playwright 検証が必要なタスクか(true/false)output_dir: 成果物の出力先(例:.multi-agent-mcp/{session_id}/reports)
update_task_status の遷移制約
update_task_statusは通常の前進遷移に使用します。completed/failed/cancelledの終端状態になったタスクを再開するときは、update_task_statusで直接戻さずreopen_taskを使用してください。
調査レポートの出力ルール
調査・検証系タスクの Markdown 成果物は
.multi-agent-mcp/{session_id}/reports/*.mdに出力します。出力先は
create_task.metadata.output_dirで明示し、Worker 指示にも同じパスを記載します。
Gtrconfig(3個)
Tool | 説明 |
| .gtrconfigの存在確認と内容取得 |
| プロジェクト構造を解析して推奨設定を提案 |
| .gtrconfigを自動生成 |
テンプレート(6個)
Tool | 説明 |
| 利用可能なテンプレート一覧を取得 |
| 特定テンプレートの詳細を取得 |
| 特定ロールのワークフローガイドを取得 |
| 利用可能なロールガイド一覧を取得 |
| 利用可能なレポートテンプレート一覧を取得 |
| 特定レポートテンプレートの内容を取得 |
スケジューラー(3個)
Tool | 説明 |
| タスクをスケジューラーキューに追加 |
| 空いているWorkerにタスクを自動割り当て |
| 現在のタスクキューを取得 |
ヘルスチェック(6個)
Tool | 説明 |
| 特定エージェントのヘルスチェックを実行 |
| 全エージェントのヘルスチェックを実行 |
| 異常なエージェント一覧を取得 |
| エージェントの復旧を試みる |
| Worker を完全復旧(agent/worktree再作成+タスク再割り当て) |
| Worker監視と段階復旧(attempt→full→failed化)を実行 |
ペルソナ(3個)
Tool | 説明 |
| タスクの説明からタスクタイプを検出 |
| タスクに最適なペルソナを取得 |
| 利用可能なペルソナ一覧を取得 |
メモリ管理(19個)
Tool | 説明 |
| 知識をプロジェクトメモリに保存 |
| プロジェクトメモリから知識を検索 |
| キーでメモリエントリを取得 |
| メモリエントリ一覧を取得 |
| メモリエントリを削除 |
| メモリのサマリー情報を取得 |
| アーカイブされたメモリを検索 |
| アーカイブエントリ一覧を取得 |
| アーカイブからエントリを復元 |
| アーカイブのサマリー情報を取得 |
| グローバルメモリに保存(全プロジェクト共通) |
| グローバルメモリから検索 |
| グローバルメモリエントリ一覧を取得 |
| グローバルメモリのサマリーを取得 |
| グローバルメモリエントリを削除 |
| グローバルアーカイブを検索 |
| グローバルアーカイブ一覧を取得 |
| グローバルアーカイブからエントリを復元 |
| グローバルアーカイブのサマリーを取得 |
スクリーンショット(4個)
Tool | 説明 |
| スクリーンショットディレクトリを取得 |
| スクリーンショット一覧(最新N件) |
| 指定ファイルを読み取り(Base64) |
| 最新のスクリーンショットを読み取り |
モデルプロファイル(3個)
Tool | 説明 |
| 現在のプロファイルを取得 |
| プロファイルを切り替え(standard/performance) |
| プロファイルの設定詳細を取得 |
switch_model_profile の方針
モデルプロファイルの正準保存先は
.multi-agent-mcp/.env(MCP_MODEL_PROFILE_ACTIVE)です。switch_model_profileは.envのみを更新し、config.jsonへは保存しません。config.jsonはセッション設定(session_id,enable_gitなど)専用です。
主要フィールド(公開I/F)
Agent
主要フィールド:
id,role,status,tmux_session,working_dir,worktree_path,current_taskグリッド/CLI 関連:
session_name,window_index,pane_index,ai_cli,ai_bootstrapped
Dashboard / Task
TaskInfo:task_file_path,metadata,started_at,completed_at,error_messagemetadataにはrequested_descriptionや運用キー(task_kindなど)を保持しますDashboard 運用フィールド:
session_started_at,session_finished_at,process_crash_count,process_recovery_count
使用例
# ターミナルを開いてtmuxワークスペースを構築(git有効)
init_tmux_workspace("/path/to/project", session_id="issue-123")
# 非gitディレクトリで実行
init_tmux_workspace("/path/to/non-git-dir", session_id="issue-123", enable_git=false)
# Ownerエージェントを作成
create_agent(
role="owner",
working_dir="/path/to/project",
)
# Workerエージェントを作成
create_agent(
role="worker",
working_dir="/path/to/worktree1",
caller_agent_id="admin-or-owner-id",
)
create_agent(
role="worker",
working_dir="/path/to/worktree2",
caller_agent_id="admin-or-owner-id",
)
# エージェント一覧を確認
list_agents(caller_agent_id="admin-or-owner-id")
# Workerにコマンドを送信
send_command(
agent_id="abc12345",
command="echo 'Hello from Worker'",
caller_agent_id="admin-or-owner-id",
)
# 出力を取得
get_output(
agent_id="abc12345",
lines=100,
caller_agent_id="admin-or-owner-id",
)
# 全Workerにコマンドをブロードキャスト
broadcast_command(
command="git status",
role="worker",
caller_agent_id="admin-or-owner-id",
)
# クリーンアップ
cleanup_workspace(caller_agent_id="owner-id")ドキュメント
各システムの詳細な解説は以下を参照してください:
ドキュメント | 説明 |
永続ファイル/ディレクトリ構造と命名規則 | |
エージェント間メッセージ通信の仕組み | |
知識の永続化・共有・アーカイブ機能 | |
Git worktree による分離作業環境 | |
タスク状態管理とダッシュボード表示 | |
Worker 監視、段階復旧、daemon 運用 | |
完了タスクブランチの統合運用 |
環境変数
変数 | デフォルト | 説明 |
| .multi-agent-mcp | MCP設定ディレクトリ名 |
| true | git 前提機能を有効化するか(falseで非gitディレクトリ許可) |
| false | worktreeを使用するか( |
| false | 画像タスクの Cursor ルーティングを有効化するか(既定 false) |
| main | メインウィンドウ名(Admin + Worker 1-6) |
| workers- | 追加Workerウィンドウ名のプレフィックス |
| 2 | 追加ウィンドウの行数 |
| 5 | 追加ウィンドウの列数 |
| 10 | 追加ウィンドウのWorker数 |
| 10.0 | コスト警告の閾値(USD) |
| 5000 | 1回のAPI呼び出しあたりの推定トークン数 |
|
| モデル別1000トークン単価テーブル(JSON) |
| 0.01 | 未定義モデル向けの汎用単価(USD/1K) |
| 60 | ヘルスチェック監視ループの実行間隔(秒) |
| 600 | 無応答判定の閾値(秒) |
| 120 |
|
| 3 | 同一worker/taskに対する復旧試行回数の上限 |
| 3 | 実作業なし検知が連続したとき daemon を自動停止する閾値 |
| 3 | Codex への Enter 再送回数の上限 |
| 250 | Codex への Enter 再送間隔(ミリ秒) |
| 2.0 | tmux への連続送信時に挟む最小待機秒数 |
| auto | ターミナルアプリ(auto: cmux→ghostty→iterm2→terminal) |
| standard | モデルプロファイル(standard/performance) |
| codex | standardプロファイルのAI CLI |
| gpt-5.5 | standardプロファイルのAdminモデル |
| gpt-5.5 | standardプロファイルのWorkerモデル |
| 6 | standardプロファイルのWorker上限 |
| 4000 | standardプロファイルのAdmin思考トークン数 |
| 4000 | standardプロファイルのWorker思考トークン数 |
| medium | standardプロファイルのAdmin推論強度 |
| medium | standardプロファイルのWorker推論強度 |
| codex | performanceプロファイルのAI CLI |
| gpt-5.5 | performanceプロファイルのAdminモデル |
| gpt-5.5 | performanceプロファイルのWorkerモデル |
| 16 | performanceプロファイルのWorker上限 |
| 30000 | performanceプロファイルのAdmin思考トークン数 |
| 4000 | performanceプロファイルのWorker思考トークン数 |
| high | performanceプロファイルのAdmin推論強度 |
| high | performanceプロファイルのWorker推論強度 |
| - | プロジェクトルート(.env読み込み用) |
| opus | Claude CLIのAdminデフォルトモデル |
| sonnet | Claude CLIのWorkerデフォルトモデル |
| gpt-5.5 | Codex CLIのAdminデフォルトモデル |
| gpt-5.5 | Codex CLIのWorkerデフォルトモデル |
| gemini-3.1-pro-high | Agy CLIのAdminデフォルトモデル |
| gemini-3.6-flash-medium | Agy CLIのWorkerデフォルトモデル |
| composer-1.5 | Cursor CLIのAdminデフォルトモデル |
| composer-1.5 | Cursor CLIのWorkerデフォルトモデル |
| uniform | Worker CLI設定モード(uniform/per-worker) |
| (empty) | per-workerモードでのWorker別CLI設定(未設定時はアクティブプロファイルCLIを利用) |
| (empty) | per-workerモードでのWorker別モデル設定(未設定時はプロファイルのWORKER_MODEL) |
| 3 | 品質チェックの最大イテレーション回数 |
| 3 | 同一問題の繰り返し上限 |
| true | 品質ゲートを厳格に適用するか |
| 1000 | メモリの最大エントリ数 |
| 90 | メモリエントリの保持期間(日) |
| [".png",".jpg",...] | スクリーンショットとして認識する拡張子 |
Worker上限は MCP_MODEL_PROFILE_ACTIVE に応じて
MCP_MODEL_PROFILE_STANDARD_MAX_WORKERS / MCP_MODEL_PROFILE_PERFORMANCE_MAX_WORKERS
のどちらかが適用されます。
MCP_MODEL_COST_TABLE_JSON の agy 分は agy models の実 ID(tier 内包、例 gemini-3.1-pro-high /
gemini-3.6-flash-medium)で構成しています。1K トークン単価は暫定見積りのため、
agy の公式単価が公開され次第、要更新です。
ディレクトリ構造
init_tmux_workspace 実行時に以下のディレクトリと .env ファイルが自動作成されます:
{project_root}/.multi-agent-mcp/
├── .env # プロジェクト設定(テンプレート付き)
├── config.json # 実行時設定(session_id / enable_git など)
├── memory/ # プロジェクトメモリ
├── screenshot/ # スクリーンショット保存先
└── {YYYYMMDD}-{HHMMSS}-{session_id}/ # セッション別(時系列プレフィックス)
├── dashboard/ # ダッシュボード
├── tasks/ # タスクファイル
└── reports/ # 調査/検証レポート(*.md)プロジェクト別設定
プロジェクトごとに設定を変更する場合、.multi-agent-mcp/.env ファイルを編集してください。
init_tmux_workspace 実行時に、設定可能な全変数がコメント付きで自動生成されます。
設定の優先順位:
環境変数(最優先)
.multi-agent-mcp/.envファイルデフォルト値
enable_git のみ、実行時は以下の優先順位で解決されます:
init_tmux_workspace(enable_git=...)の引数.multi-agent-mcp/config.jsonのenable_git環境変数 /
.envデフォルト値(
true)
gitignore 推奨
タスクファイルやダッシュボードは .multi-agent-mcp/ ディレクトリに出力されます。
このディレクトリは一時ファイルなので、.gitignore に追加することを推奨します。
# プロジェクトの .gitignore に追加
echo ".multi-agent-mcp/" >> .gitignore開発(コントリビューター向け)
ローカルで開発する場合は、リポジトリをクローンしてください。
# リポジトリをクローン
git clone https://github.com/shiiman/multi-agent-mcp.git
cd multi-agent-mcp
# 開発用依存関係をインストール
uv sync --all-extras
# テストを実行
uv run pytest
# 高速反復(キーワードで対象テストのみ)
uv run pytest -k healthcheck
# 高速反復(ファイル単位)
uv run pytest tests/test_healthcheck_manager.py
# リンターを実行
uv run ruff check src/トラブルシューティング
tmux セッションが見つからない
エラー: tmux セッションが見つかりません原因: tmux がインストールされていないか、ワークスペースが初期化されていません。
対処法:
tmux -Vで tmux のインストールを確認init_tmux_workspaceでワークスペースを初期化
Worker が応答しない(stall 検出)
原因: AI CLI プロセスがハングアップしている可能性があります。
対処法:
healthcheck_agentで状態を確認attempt_recoveryで軽量復旧を試行それでも改善しない場合は
full_recoveryで完全復旧
dashboard.md が読み込めない
原因: YAML Front Matter のフォーマットが壊れている可能性があります。
対処法:
.multi-agent-mcp/{session_id}/dashboard/dashboard.mdを削除get_dashboardを実行すると自動で再生成されます
MCP サーバーが起動しない
原因: 依存パッケージのバージョン不整合の可能性があります。
対処法:
# キャッシュクリア + 再インストール
uv cache clean multi-agent-mcp
uv tool install --force --from git+https://github.com/shiiman/multi-agent-mcp multi-agent-mcpライセンス
MIT
Available Tools
90 toolsanalyze_project_for_gtrconfigC
プロジェクト構造を解析して推奨設定を提案する。
※ Owner と Admin のみ使用可能。
Args: project_path: プロジェクトのルートパス caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 推奨設定(success, recommended_config)
Inputs: project_path (required), caller_agent_id. Returns: object
assign_task_to_agentB
タスクをエージェントに割り当てる。
※ Admin のみ使用可能。
Args: task_id: タスクID agent_id: エージェントID branch: 作業ブランチ(オプション) worktree_path: worktreeパス(オプション) caller_agent_id: 呼び出し元エージェントID(ロールチェック用)
Returns: 割り当て結果(success, task_id, agent_id, message または error)
Inputs: task_id (required), agent_id (required), branch, worktree_path, +1 more. Returns: object
assign_worktreeB
エージェントにworktreeを割り当てる。
※ Owner と Admin のみ使用可能。
Args: agent_id: エージェントID worktree_path: worktreeのパス branch: ブランチ名 caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 割り当て結果(success, agent_id, worktree_path, message または error)
Inputs: branch (required), agent_id (required), worktree_path (required), caller_agent_id. Returns: object
attempt_recoveryC
エージェントの復旧を試みる。
※ Owner と Admin のみ使用可能。
Args: agent_id: エージェントID caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 復旧結果(success, message)
Inputs: agent_id (required), caller_agent_id. Returns: object
auto_assign_tasksA
空いているWorkerにタスクを自動割り当てする。
※ Admin のみ使用可能。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 割り当て結果(success, assignments, count)
Inputs: caller_agent_id. Returns: object
broadcast_commandA
全エージェント(または特定役割)にコマンドをブロードキャストする。
※ Owner と Admin のみ使用可能。
Args: command: 実行するコマンド role: 対象の役割(省略時は全員、有効: owner/admin/worker) allow_dangerous: 危険判定コマンドを明示許可するか caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 送信結果(success, command, role_filter, results, summary または error)
Inputs: command (required), role, allow_dangerous, caller_agent_id. Returns: object
check_all_tasks_completedA
全タスクが完了したかチェックする。
完了条件: pending=0, in_progress=0, failed=0 failedタスクがある場合は完了と見なさない。
※ Owner のみ使用可能。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: is_all_completed: 全タスク完了か total_tasks: 総タスク数 pending_tasks: 未着手タスク数 in_progress_tasks: 進行中タスク数 completed_tasks: 完了タスク数 failed_tasks: 失敗タスク数
Inputs: caller_agent_id. Returns: object
check_gtr_availableC
gtr (git-worktree-runner) が利用可能か確認する。
※ Owner と Admin のみ使用可能。
Args: repo_path: リポジトリのパス caller_agent_id: 呼び出し元エージェントID(必須)
Returns: gtrの利用可否(success, gtr_available, message)
Inputs: repo_path (required), caller_agent_id. Returns: object
check_gtrconfigB
Gtrconfigの存在確認と内容取得。
※ Owner と Admin のみ使用可能。
Args: project_path: プロジェクトのルートパス caller_agent_id: 呼び出し元エージェントID(必須)
Returns: Gtrconfig状態(success, status)
Inputs: project_path (required), caller_agent_id. Returns: object
cleanup_on_completionA
全タスク完了時にワークスペースをクリーンアップする。
タスクが完了していない場合はエラーを返す。 force=True で未完了でも強制クリーンアップ。
※ Owner のみ使用可能。
Args: force: 未完了でも強制的にクリーンアップするか repo_path: メインリポジトリのパス(worktree 削除に使用) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: クリーンアップ結果
Inputs: force, repo_path, caller_agent_id. Returns: object
cleanup_workspaceA
ワークスペースをクリーンアップする。
全エージェントを終了し、リソースを解放する。
※ Owner のみ使用可能。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: クリーンアップ結果(success, terminated_sessions, cleared_agents, message)
Inputs: caller_agent_id. Returns: object
create_agentB
新しいエージェントを作成する。
単一セッション方式: 左右40:60分離レイアウト
Owner: tmux ペインに配置しない(実行AIエージェントが担う)
左 40%: Admin (pane 0)
右 60%: Worker 1-6 (pane 1-6)
Worker 7以降は追加ウィンドウ(2×5=10ペイン/ウィンドウ)
※ Owner と Admin のみ使用可能。
Args: role: エージェントの役割(owner/admin/worker) working_dir: 作業ディレクトリのパス ai_cli: 使用するAI CLI(claude/codex/agy/cursor、省略でデフォルト) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 作成結果(success, agent, message または error)
Inputs: role (required), working_dir (required), ai_cli, caller_agent_id. Returns: object
create_taskB
新しいタスクを作成する。
※ Owner と Admin のみ使用可能。
Args: title: タスクタイトル description: タスク説明 assigned_agent_id: 割り当て先エージェントID(オプション) branch: 作業ブランチ(オプション) metadata: 追加メタデータ(オプション) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 作成結果(success, task, message または error)
Inputs: title (required), branch, metadata, description, +2 more. Returns: object
create_workers_batchC
複数 Worker を並列作成し、タスク割り当て・送信も実行する。※ Owner/Admin のみ。
Inputs: repo_path (required), base_branch (required), worker_configs (required), session_id, +2 more. Returns: object
create_worktreeA
新しいgit worktreeを作成する。
※ Owner と Admin のみ使用可能。
Args: repo_path: メインリポジトリのパス worktree_path: 作成するworktreeのパス branch: ブランチ名 create_branch: 新しいブランチを作成するか(デフォルト: True) base_branch: 基点ブランチ(create_branch=Trueの場合のみ有効) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 作成結果(success, worktree_path, branch, message または error)
Inputs: branch (required), repo_path (required), worktree_path (required), base_branch, +2 more. Returns: object
delete_global_memory_entryA
グローバルメモリエントリを削除する(全プロジェクト共通)。
※ Owner と Admin のみ使用可能。
Args: key: 削除するエントリのキー caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 削除結果(success, key, message)
Inputs: key (required), caller_agent_id. Returns: object
delete_memory_entryC
メモリエントリを削除する。
※ Owner と Admin のみ使用可能。
Args: key: 削除するエントリのキー caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 削除結果(success, key, message)
Inputs: key (required), caller_agent_id. Returns: object
detect_task_typeC
タスクの説明からタスクタイプを検出する。
※ Admin のみ使用可能。
Args: task_description: タスクの説明文 caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 検出結果(success, task_type, persona)
Inputs: task_description (required), caller_agent_id. Returns: object
enqueue_taskB
タスクをスケジューラーキューに追加する。
※ Admin のみ使用可能。
Args: task_id: タスクID priority: 優先度(critical/high/medium/low) dependencies: 依存タスクのIDリスト caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 追加結果(success, task_id, priority, message または error)
Inputs: task_id (required), priority, dependencies, caller_agent_id. Returns: object
full_recoveryA
異常なエージェントの完全復旧を実行する。
以下のステップで復旧を行う:
古い agent を terminate
古い worktree を remove(存在する場合)
新しい worktree を作成(同じブランチ名で)
新しい agent を作成
未完了のタスクを新しい agent に再割り当て
※ Admin のみ使用可能。
Args: agent_id: 復旧対象のエージェントID caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 復旧結果(success, old_agent_id, new_agent_id, reassigned_tasks, message)
Inputs: agent_id (required), caller_agent_id. Returns: object
generate_gtrconfigC
Gtrconfigを自動生成する。
※ Owner のみ使用可能。
Args: project_path: プロジェクトのルートパス overwrite: 既存ファイルを上書きするか caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 生成結果(success, config, message または error)
Inputs: project_path (required), overwrite, caller_agent_id. Returns: object
get_agent_statusB
指定エージェントの詳細ステータスを取得する。
Args: agent_id: エージェントID caller_agent_id: 呼び出し元エージェントID(必須)
Returns: エージェント詳細(success, agent, session_active または error)
Inputs: agent_id (required), caller_agent_id. Returns: object
get_cost_estimateC
現在のコスト推定を取得する。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: コスト推定(success, estimate, warning)
Inputs: caller_agent_id. Returns: object
get_cost_summaryC
コストサマリーを取得する。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: コストサマリー(success, summary)
Inputs: caller_agent_id. Returns: object
get_dashboardC
ダッシュボード全体を取得する。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: ダッシュボード情報(success, dashboard)
Inputs: caller_agent_id. Returns: object
get_dashboard_summaryC
ダッシュボードのサマリーを取得する。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: サマリー情報(success, summary)
Inputs: caller_agent_id. Returns: object
get_global_memory_archive_summaryB
グローバルアーカイブのサマリー情報を取得する(全プロジェクト共通)。
※ Owner と Admin のみ使用可能。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: サマリー情報(success, summary)
Inputs: caller_agent_id. Returns: object
get_global_memory_summaryA
グローバルメモリのサマリー情報を取得する(全プロジェクト共通)。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: サマリー情報(success, summary)
Inputs: caller_agent_id. Returns: object
get_memory_archive_summaryB
アーカイブのサマリー情報を取得する。
※ Owner と Admin のみ使用可能。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: サマリー情報(success, summary)
Inputs: caller_agent_id. Returns: object
get_memory_entryB
キーでメモリエントリを取得する。
Args: key: エントリのキー caller_agent_id: 呼び出し元エージェントID(必須)
Returns: エントリ情報(success, entry または error)
Inputs: key (required), caller_agent_id. Returns: object
get_memory_summaryC
メモリのサマリー情報を取得する。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: サマリー情報(success, summary)
Inputs: caller_agent_id. Returns: object
get_model_profileC
現在のモデルプロファイルを取得する。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: プロファイル情報(success, active_profile, settings)
Inputs: caller_agent_id. Returns: object
get_model_profile_settingsC
モデルプロファイルの設定詳細を取得する。
Args: profile: プロファイル名(省略時は全プロファイル) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: プロファイル設定の詳細
Inputs: profile, caller_agent_id. Returns: object
get_optimal_personaB
タスクに最適なペルソナを取得する。
※ Admin のみ使用可能。
Args: task_description: タスクの説明文 caller_agent_id: 呼び出し元エージェントID(必須)
Returns: ペルソナ情報(success, persona)
Inputs: task_description (required), caller_agent_id. Returns: object
get_outputA
エージェントのtmux出力を取得する。
※ Owner と Admin のみ使用可能。
Args: agent_id: 対象エージェントID lines: 取得する行数(デフォルト: 50) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 出力内容(success, agent_id, lines, output または error)
Inputs: agent_id (required), lines, caller_agent_id. Returns: object
get_report_templateA
レポートテンプレートの内容を取得する。
指定されたレポートテンプレートの全文を返します。 テンプレートをコピーして、プレースホルダーを実際の内容に 置き換えてレポートを作成してください。
Args: template_name: テンプレート名(拡張子なし。例: "security", "general") caller_agent_id: 呼び出し元エージェントID(必須)
Returns: テンプレート内容(success, template_name, category, content または error)
Inputs: template_name (required), caller_agent_id. Returns: object
get_role_guideA
ロール別の振る舞いガイドを取得する。
templates/{role}.md からテンプレートを読み込み、 各ロールの責務、やること/やらないこと、振る舞いを取得します。
Args: role: ロール名(owner, admin, worker) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: ロールガイド(success, guide または error)
Inputs: role (required), caller_agent_id. Returns: object
get_screenshot_dirC
スクリーンショットディレクトリを取得する。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: ディレクトリ情報(success, path, exists)
Inputs: caller_agent_id. Returns: object
get_taskC
タスクの詳細を取得する。
Args: task_id: タスクID caller_agent_id: 呼び出し元エージェントID(必須)
Returns: タスク詳細(success, task または error)
Inputs: task_id (required), caller_agent_id. Returns: object
get_task_queueB
現在のタスクキューを取得する。
※ Owner と Admin のみ使用可能。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: キュー状態(success, queue)
Inputs: caller_agent_id. Returns: object
get_unhealthy_agentsB
異常なエージェント一覧を取得する。
※ Owner と Admin のみ使用可能。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 異常エージェント一覧(success, unhealthy_agents, count)
Inputs: caller_agent_id. Returns: object
get_unread_countB
エージェントの未読メッセージ数を取得する。
Args: agent_id: エージェントID caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 未読数(success, agent_id, unread_count)
Inputs: agent_id (required), caller_agent_id. Returns: object
get_workspace_templateB
特定テンプレートの詳細を取得する。
Args: template_name: テンプレート名 caller_agent_id: 呼び出し元エージェントID(必須)
Returns: テンプレート詳細(success, template または error)
Inputs: template_name (required), caller_agent_id. Returns: object
get_worktree_statusC
指定worktreeのgitステータスを取得する。
Args: repo_path: メインリポジトリのパス worktree_path: worktreeのパス caller_agent_id: 呼び出し元エージェントID(必須)
Returns: ステータス情報(success, status または error)
Inputs: repo_path (required), worktree_path (required), caller_agent_id. Returns: object
healthcheck_agentB
特定エージェントのヘルスチェックを実行する。
※ Owner と Admin のみ使用可能。
Args: agent_id: エージェントID caller_agent_id: 呼び出し元エージェントID(必須)
Returns: ヘルス状態(success, health_status)
Inputs: agent_id (required), caller_agent_id. Returns: object
healthcheck_allB
全エージェントのヘルスチェックを実行する。
※ Owner と Admin のみ使用可能。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 全ヘルス状態(success, statuses, summary)
Inputs: caller_agent_id. Returns: object
initialize_agentA
エージェントを初期化し、ロールテンプレートを渡して AI CLI を起動する。
create_agent で作成されたエージェントに対して、roles/ テンプレートを 初期プロンプトとして渡し、ターミナルで AI CLI を起動する。
※ Owner と Admin のみ使用可能。
Args: agent_id: 初期化するエージェントID prompt_type: プロンプトタイプ - "auto": roles/ テンプレートを自動読み込み(デフォルト) - "custom": custom_prompt をそのまま使用 - "file": custom_prompt をファイルパスとして読み込み custom_prompt: カスタムプロンプト(prompt_type が "custom" または "file" の場合) terminal: ターミナルアプリ(auto/ghostty/iterm2/terminal) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 初期化結果(success, agent_id, cli, prompt_source, message)
Inputs: agent_id (required), terminal, prompt_type, custom_prompt, +1 more. Returns: object
init_tmux_workspaceA
ターミナルを開いてtmuxワークスペース(グリッドレイアウト)を構築する。
ターミナルを先に起動し、その中でtmuxセッション作成・ペイン分割を行う。 セッションが既に存在する場合はattachのみ行う。 gtr が利用可能な場合、gtrconfig を自動確認・生成する。
レイアウト: ┌─────────────┬────────┬────────┬────────┐ │ pane 0 │ pane 1 │ pane 3 │ pane 5 │ │ (Admin) ├────────┼────────┼────────┤ │ (40%) │ pane 2 │ pane 4 │ pane 6 │ └─────────────┴────────┴────────┴────────┘ 左40% 右60% (Workers 1-6)
※ Owner のみ使用可能。
Args: working_dir: 作業ディレクトリのパス open_terminal: Trueでターミナルを開いて表示(デフォルト)、 Falseでバックグラウンド作成 auto_setup_gtr: gtr利用可能時に自動でgtrconfig設定(デフォルト: True) session_id: セッションID(省略時は None、指定時はディレクトリ構造に使用) enable_git: git 機能を有効化するか(省略時は config/.env を使用) caller_agent_id: 呼び出し元エージェントID(指定時はロールチェック)
Returns: 初期化結果(success, session_name, gtr_status, message または error)
Inputs: working_dir (required), enable_git, session_id, open_terminal, +2 more. Returns: object
list_agentsA
全エージェントの一覧を取得する。
ファイルに保存されたエージェント情報も含めて返す。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: エージェント一覧(success, agents, count, synced_from_file)
Inputs: caller_agent_id. Returns: object
list_global_memory_archiveA
グローバルアーカイブエントリ一覧を取得する(全プロジェクト共通)。
※ Owner と Admin のみ使用可能。
Args: limit: 最大結果数(デフォルト: 50) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: エントリ一覧(success, entries, count)
Inputs: limit, caller_agent_id. Returns: object
list_global_memory_entriesC
グローバルメモリエントリ一覧を取得する(全プロジェクト共通)。
Args: tags: フィルタリングするタグ(オプション) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: エントリ一覧(success, entries, count)
Inputs: tags, caller_agent_id. Returns: object
list_memory_archiveA
アーカイブされたメモリエントリ一覧を取得する。
※ Owner と Admin のみ使用可能。
Args: limit: 最大結果数(デフォルト: 50) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: エントリ一覧(success, entries, count)
Inputs: limit, caller_agent_id. Returns: object
list_memory_entriesA
メモリエントリ一覧を取得する。
Args: tags: フィルタリングするタグ(オプション) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: エントリ一覧(success, entries, count)
Inputs: tags, caller_agent_id. Returns: object
list_personasB
利用可能なペルソナ一覧を取得する。
※ Admin のみ使用可能。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: ペルソナ一覧(success, personas, count)
Inputs: caller_agent_id. Returns: object
list_report_templatesA
利用可能なレポートテンプレート一覧を取得する。
レポート作成時に使用できるテンプレートの一覧を返します。 テンプレートは「コード調査」「統合レポート」「汎用調査」の 3カテゴリに分類されています。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: テンプレート一覧(success, templates, categories)
Inputs: caller_agent_id. Returns: object
list_role_guidesA
利用可能なロールガイド一覧を取得する。
templates/ ディレクトリ内の .md ファイルを検索します。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: ロール名のリスト
Inputs: caller_agent_id. Returns: object
list_screenshotsC
スクリーンショット一覧を取得する(最新順)。
Args: limit: 最大取得件数(デフォルト: 10) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: スクリーンショット一覧(success, screenshots, count)
Inputs: limit, caller_agent_id. Returns: object
list_tasksB
タスク一覧を取得する。
Args: status: フィルターするステータス(オプション) agent_id: フィルターするエージェントID(オプション) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: タスク一覧(success, tasks, count または error)
Inputs: status, agent_id, caller_agent_id. Returns: object
list_workspace_templatesC
利用可能なテンプレート一覧を取得する。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: テンプレート一覧(success, templates, names)
Inputs: caller_agent_id. Returns: object
list_worktreesC
リポジトリのworktree一覧を取得する。
Args: repo_path: メインリポジトリのパス caller_agent_id: 呼び出し元エージェントID(必須)
Returns: worktree一覧(success, worktrees, count または error)
Inputs: repo_path (required), caller_agent_id. Returns: object
merge_completed_tasksC
完了タスクの作業ブランチを base_branch に統合する。
Inputs: repo_path (required), session_id (required), base_branch (required), strategy, +1 more. Returns: object
monitor_and_recover_workersC
Worker を監視し、異常時に復旧を実行する。
Inputs: caller_agent_id. Returns: object
open_sessionC
エージェントのtmuxセッションをターミナルアプリで開く。
優先順位: ghostty → iTerm2 → Terminal.app
※ Owner のみ使用可能。
Args: agent_id: エージェントID caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 開く結果(success, agent_id, session, message または error)
Inputs: agent_id (required), caller_agent_id. Returns: object
open_worktree_with_aiB
gtr ai コマンドでworktreeをAIツール(AI CLI)で開く。
gtr がインストールされている場合のみ使用可能。
※ Owner と Admin のみ使用可能。
Args: repo_path: リポジトリのパス branch: ブランチ名 caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 実行結果(success, branch, message または error)
Inputs: branch (required), repo_path (required), caller_agent_id. Returns: object
read_latest_screenshotC
最新のスクリーンショットを読み取る(Base64)。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 画像データ(success, filename, base64_data, mime_type)
Inputs: caller_agent_id. Returns: object
read_messagesB
エージェントのメッセージを読み取る。
Args: agent_id: エージェントID unread_only: 未読のみ取得するか message_type: フィルターするメッセージタイプ mark_as_read: 既読としてマークするか caller_agent_id: 呼び出し元エージェントID(必須)
Returns: メッセージ一覧(success, messages, count または error)
Inputs: agent_id (required), unread_only, mark_as_read, message_type, +1 more. Returns: object
read_screenshotB
指定したスクリーンショットを読み取る(Base64)。
Args: filename: ファイル名 caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 画像データ(success, filename, base64_data, mime_type)
Inputs: filename (required), caller_agent_id. Returns: object
register_agent_to_ipcC
エージェントをIPCシステムに登録する。
Args: agent_id: エージェントID caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 登録結果(success, agent_id, message)
Inputs: agent_id (required), caller_agent_id. Returns: object
remove_taskA
タスクを削除する。
※ Owner と Admin のみ使用可能。
Args: task_id: タスクID caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 削除結果(success, task_id, message または error)
Inputs: task_id (required), caller_agent_id. Returns: object
remove_worktreeB
git worktreeを削除する。
※ Owner と Admin のみ使用可能。
Args: repo_path: メインリポジトリのパス worktree_path: 削除するworktreeのパス force: 強制削除するか(デフォルト: False) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 削除結果(success, worktree_path, message または error)
Inputs: repo_path (required), worktree_path (required), force, caller_agent_id. Returns: object
reopen_taskC
終端タスクを再開する。
※ Admin のみ使用可能。
Args: task_id: 再開するタスクID reset_progress: 進捗率を 0 に戻すか caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 再開結果(success, task_id, message または error)
Inputs: task_id (required), reset_progress, caller_agent_id. Returns: object
report_task_completionA
Worker が Admin にタスク完了を報告する。
Worker はこのツールを使って Admin に作業結果を報告します。 Admin が受け取って dashboard を更新します。 自動的にメモリ保存とメトリクス更新も行います。
※ Worker のみ使用可能。
Args: task_id: 完了したタスクのID status: 結果ステータス("completed" | "failed") message: 完了報告メッセージ(作業内容の要約) summary: タスク結果のサマリー(メモリに保存、省略時はmessageを使用) caller_agent_id: 呼び出し元エージェントID(Worker のID)
Returns: 報告結果(success, message または error)
Inputs: status (required), message (required), task_id (required), summary, +1 more. Returns: object
report_task_progressA
Worker がタスクの進捗を報告する。
Worker は 10% ごとに進捗を報告することで、Admin と Owner が リアルタイムで作業状況を把握できます。
チェックリストを使用する場合、進捗率は自動計算されます。
※ Worker のみ使用可能。
Args: task_id: タスクID progress: 進捗率(0-100、10% 単位で報告推奨。checklist使用時は自動計算) message: 進捗メッセージ(現在の作業内容など、ログに追加されます) checklist: チェックリスト [{"text": "項目名", "completed": true/false}, ...] caller_agent_id: 呼び出し元エージェントID(Worker のID)
Returns: 報告結果(success, task_id, progress, message または error)
Inputs: task_id (required), message, progress, checklist, +1 more. Returns: object
reset_cost_counterA
コストカウンターをリセットする。
※ Owner のみ使用可能。
Args: caller_agent_id: 呼び出し元エージェントID(必須)
Returns: リセット結果(success, deleted_count, message)
Inputs: caller_agent_id. Returns: object
restore_from_global_memory_archiveA
グローバルアーカイブからエントリを復元する(全プロジェクト共通)。
※ Owner と Admin のみ使用可能。
Args: key: 復元するエントリのキー caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 復元結果(success, entry, message または error)
Inputs: key (required), caller_agent_id. Returns: object
restore_from_memory_archiveC
アーカイブからメモリエントリを復元する。
※ Owner と Admin のみ使用可能。
Args: key: 復元するエントリのキー caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 復元結果(success, entry, message または error)
Inputs: key (required), caller_agent_id. Returns: object
retrieve_from_global_memoryB
グローバルメモリから知識を検索する(全プロジェクト共通)。
Args: query: 検索クエリ tags: フィルタリングするタグ(オプション) limit: 最大結果数 caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 検索結果(success, entries, count)
Inputs: query (required), tags, limit, caller_agent_id. Returns: object
retrieve_from_memoryC
メモリから知識を検索する。
Args: query: 検索クエリ tags: フィルタリングするタグ(オプション) limit: 最大結果数 caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 検索結果(success, entries, count)
Inputs: query (required), tags, limit, caller_agent_id. Returns: object
save_to_global_memoryB
知識をグローバルメモリに保存する(全プロジェクト共通)。
保存先: ~/.multi-agent-mcp/memory/
Args: key: エントリのキー(一意な識別子) content: 保存するコンテンツ tags: タグのリスト(オプション) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 保存結果(success, entry, message)
Inputs: key (required), content (required), tags, caller_agent_id. Returns: object
save_to_memoryC
知識をメモリに保存する。
Args: key: エントリのキー(一意な識別子) content: 保存するコンテンツ tags: タグのリスト(オプション) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 保存結果(success, entry, message)
Inputs: key (required), content (required), tags, caller_agent_id. Returns: object
search_global_memory_archiveB
グローバルアーカイブを検索する(全プロジェクト共通)。
※ Owner と Admin のみ使用可能。
Args: query: 検索クエリ tags: フィルタリングするタグ(オプション) limit: 最大結果数 caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 検索結果(success, entries, count)
Inputs: query (required), tags, limit, caller_agent_id. Returns: object
search_memory_archiveA
アーカイブされたメモリを検索する。
prune で移動されたエントリを検索できる。
※ Owner と Admin のみ使用可能。
Args: query: 検索クエリ tags: フィルタリングするタグ(オプション) limit: 最大結果数 caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 検索結果(success, entries, count)
Inputs: query (required), tags, limit, caller_agent_id. Returns: object
send_commandB
指定エージェントにコマンドを送信する。
※ Owner と Admin のみ使用可能。
Args: agent_id: 対象エージェントID command: 実行するコマンド allow_dangerous: 危険判定コマンドを明示許可するか caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 送信結果(success, agent_id, command, message または error)
Inputs: command (required), agent_id (required), allow_dangerous, caller_agent_id. Returns: object
send_messageB
エージェント間でメッセージを送信する。
Args: sender_id: 送信元エージェントID receiver_id: 宛先エージェントID(Noneでブロードキャスト) message_type: メッセージタイプ(task_assign, task_complete, etc.) content: メッセージ内容 subject: 件名(オプション) priority: 優先度(low/normal/high/urgent) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 送信結果(success, message_id, message または error)
Inputs: content (required), sender_id (required), receiver_id (required), message_type (required), +3 more. Returns: object
send_taskB
タスク指示をファイル経由でエージェントに送信する。※ Owner と Admin のみ使用可能。
Args: agent_id: エージェントID task_content: タスク内容(Markdown形式) session_id: Issue番号または一意なタスクID auto_enhance: 自動拡張を行うか(デフォルト: True) branch_name: 作業ブランチ名(Admin 用、省略時は feature/{session_id}) report_template: レポートテンプレート名(例: "security", "general")。 指定するとテンプレートのファイルパスが Worker のタスク指示に注入される。 caller_agent_id: 呼び出し元エージェントID(必須)
Inputs: agent_id (required), session_id (required), task_content (required), branch_name, +3 more. Returns: object
set_cost_warning_thresholdB
コスト警告の閾値を設定する。
※ Owner のみ使用可能。
Args: threshold_usd: 新しい閾値(USD) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 設定結果(success, threshold, message)
Inputs: threshold_usd (required), caller_agent_id. Returns: object
switch_model_profileA
モデルプロファイルを切り替える。
※ Owner のみ使用可能。
Args: profile: 切り替え先プロファイル(standard/performance) caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 切り替え結果(success, previous_profile, current_profile, settings)
Notes:
永続化先は .multi-agent-mcp/.env の MCP_MODEL_PROFILE_ACTIVE のみ。
config.json には保存しない。
Inputs: profile (required), caller_agent_id. Returns: object
terminate_agentB
エージェントを終了する。
グリッドレイアウトではペインは維持され、再利用可能になる。
※ Owner と Admin のみ使用可能。
Args: agent_id: 終了するエージェントID caller_agent_id: 呼び出し元エージェントID(必須)
Returns: 終了結果(success, agent_id, message または error)
Inputs: agent_id (required), caller_agent_id. Returns: object
unlock_owner_waitB
Owner の待機ロックを手動解除する。
Args: reason: 解除理由 caller_agent_id: 呼び出し元エージェントID(必須) ctx: MCP Context
Returns: 解除結果
Inputs: reason, caller_agent_id. Returns: object
update_task_statusA
タスクのステータスを更新する。
※ Admin のみ使用可能。Worker は report_task_completion を使用してください。
Args: task_id: タスクID status: 新しいステータス(pending/in_progress/blocked/completed/failed/cancelled) progress: 進捗率(0-100) error_message: エラーメッセージ(failedの場合) caller_agent_id: 呼び出し元エージェントID(ロールチェック用)
Returns: 更新結果(success, task_id, status, message または error)
Inputs: status (required), task_id (required), progress, error_message, +1 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 90 tools
Many tools have clear distinct purposes, but there is significant overlap in areas like task management (create_task, enqueue_task, assign_task_to_agent, send_task) and memory retrieval (retrieve_from_memory, search_memory_archive, get_memory_entry). Also cleanup_workspace and cleanup_on_completion overlap, and check_gtr_available/check_gtrconfig are confusingly similar.
Most tools follow a consistent verb_noun pattern (get_, list_, create_, update_, delete_, remove_, send_, etc.). Minor deviations exist such as 'merge_completed_tasks' (verb_adjective_noun) and 'monitor_and_recover_workers' (compound verb) but these are understandable.
90 tools is an extremely high count. Even for a multi-agent orchestration system, this is far beyond what an agent can reasonably navigate. The count is justified by the breadth of the domain, but it represents a severe cognitive load and should be split into multiple focused servers.
The domain coverage is remarkably thorough: agent lifecycle, task lifecycle, worktree management, messaging, memory, health checks, screenshots, cost tracking, and model profiles. Minor gaps include no explicit update_agent or update_worktree tools, but most operational cycles are complete.
Maintenance
Related MCP Connectors
Your AI apps as one team: hand work to Codex or Claude Code on your Mac, with a shared logbook.
Run your AI-run company from Claude Code, Codex, Cursor or ChatGPT: inbox, tasks, team, Studio.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Capture coding-agent sessions and resume them in any other agent: Claude Code, Codex, Cursor, more.
Related MCP Servers
- AlicenseAqualityDmaintenanceOrchestrates multiple Claude Code agents across iTerm2 sessions with process-level isolation, enabling collaborative AI development workflows on multiple codebases with task-based inter-agent communication and persistent state management.71MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude Code to orchestrate a team of independent Claude Code sessions within iTerm2 for parallel task execution and isolated git worktree management. It provides tools to spawn, monitor, and message worker sessions while maintaining full visibility and control over their terminal windows.35 PyPI48MIT
- AlicenseAqualityDmaintenanceEnables AI agents to spawn, interact with, and orchestrate multiple concurrent terminal sessions via tmux.9MIT
- AlicenseNot gradedqualityDmaintenanceCreates and manages multi-agent teams of AI coding assistants (Claude Code, Codex CLI) that collaborate in tmux terminal sessions. Enables a leader agent to assign sub-tasks to team members for coordinated development.1ISC