Agent Deck CLI
AIエージェントのターミナルセッションマネージャー。子Claudeセッションの起動、制御、結果取得を可能にします。
サブエージェントの起動
トリガー: 「エージェントを起動して」「サブエージェントを起動して」「launch sub-agent」
シンプルな起動（CLIコマンド）
# セッションを作成
agent-deck add -t "名前" -c claude /path/to/workdir
# 現在のエージェントの子セッションとして作成
agent-deck add -t "名前" --parent "親" -c claude /path/to/workdir
# 起動
agent-deck session start "名前"
# タスクを送信
agent-deck session send "名前" "あなたのタスク..."
自動起動（スクリプト）
scripts/launch-subagent.sh "名前" "プロンプト" [--mcp exa] [--wait]
スクリプトは自動的に:
- 現在のセッションとプロファイルを特定
- 子セッションを作成
- Claudeの初期化を待機
- プロンプトを送信
結果取得モード
| モード | コマンド | 使用タイミング |
|---|---|---|
| Fire & forget | （--waitなし） | デフォルト。「準備ができたら教えて」と言う場合 |
| On-demand | agent-deck session output "名前" | ユーザーが尋ねたとき |
| Blocking | --wait | 即座に結果が必要なとき |
ステータス確認
トリガー: 「セッションを確認して」「ステータスを確認して」「check session」
agent-deck status # 全セッション（サマリー）
agent-deck session show "名前" # 特定のセッションの詳細
agent-deck session show -json "名前" # JSON形式
agent-deck session current # 現在のセッション（作業中のセッション）
agent-deck session current --json # 現在のセッションをJSONで
ステータス:
●実行中 (running)◐入力待ち (waiting)○アイドル (idle)✕エラー (error)
結果の取得
トリガー: 「エージェントの出力を見せて」「エージェントが何と答えたか」「show agent output」
agent-deck session output "名前"
MCP接続
agent-deck mcp list # 利用可能なMCPサーバー一覧
agent-deck mcp attach "名前" exa # セッションにMCPを接続
agent-deck session restart "名前" # 接続後は**必ず**再起動！
推奨MCP
| タスク | MCPサーバー |
|---|---|
| Web検索 | exa, firecrawl |
| コードドキュメント | context7 |
| 複雑な推論 | sequential-thinking |
セッション管理
# ライフサイクル
agent-deck session start "名前"
agent-deck session stop "名前"
agent-deck session restart "名前"
# 全セッション一覧
agent-deck ls
agent-deck ls -json
# セッション削除
agent-deck rm "名前"
重要なルール
- フラグは引数の前に:
session show -json name（session show name -jsonではない） - mcp attachの後は必ず
session restartで変更を適用 - 他エージェントの結果をポーリングしない — ターゲットセッションに悪影響を与える可能性があります
- セッションの識別: 名前、ID（6文字以上）、またはパスを使用可能
使用例
調査エージェントの起動
# Web調査用エージェントを作成
agent-deck add -t "Researcher" -c claude --mcp exa /tmp/research
agent-deck session start "Researcher"
agent-deck session send "Researcher" "AIの最新トレンドに関する情報を探して"
準備完了の確認
# ステータスを確認
agent-deck session show "Researcher"
# ステータスが◐（waiting）ならエージェントは完了、結果を取得:
agent-deck session output "Researcher"