Agent Deck 完全ガイド 2026：1つのTUIですべてのAIコーディングエージェントを管理

本記事は Agent Deck v1.9.57（2026-06-12 リリース）に基づいています。PR番号は#1408に達し、プロジェクトの更新は非常に活発です。

1. なぜAIエージェントマネージャーが必要なのか？

2026年のAIコーディングツールエコシステムは大きく変わりました。1年前なら、Claude CodeかAiderのどちらか1つあれば十分だったかもしれません。しかし今日では、中上級開発者の典型的なワークフローはこんな感じです：

• Claude Code でコアビジネスロジックを処理
• OpenCode でコードレビュー
• Codex でユニットテスト作成
• Gemini CLI でクイックプロトタイプ検証
• Pi でドキュメント生成

計算すると、5つのAIエージェント × 3つのプロジェクト = 15個のターミナルタブです。これに手動で開くデバッグターミナルやデータベースクライアント、ログビューアは含まれていません。

ターミナルタブ地獄

こんな経験はありませんか？

• どのタブがどのエージェントかわからなくなって、間違ったブランチで git checkout してしまった
• Claude Codeが返信を待っているのに、そのタブがどこだか見つからない
• いくつかのClaudeセッション間で会話の流れをコピーしたいのに、手動でコピペするしかない
• MCPの設定ファイルがグチャグチャになって、プロジェクトを変えるたびに手動で修正している

既存アプローチの問題点

Agent Deck はまさにこの問題を解決するために作られました。AIコーディングツールそのものではなく、すべてのAIコーディングツールのコントロールセンターなのです。

2. Agent Deck とは？

Agent Deck（GitHub: asheshgoplani/agent-deck）は、AIコーディングエージェント専用に設計されたオープンソースのターミナルセッションマネージャーです。tmuxをベースに構築されており、単一のターミナルウィンドウ内でTUI（ターミナルユーザーインターフェース）を提供します。これにより、以下のことが可能になります：

• すべてのAIエージェントの状態（実行中 / 入力待ち / アイドル / エラー）を一目で把握
• ワンクリックでエージェントを切り替え
• セッションのFork、既存の会話から新しいアイデアを分岐
• MCPサービスとClaude Skillsを視覚的に管理
• 複数のAIエージェントをリモートで監視・オーケストレーション（Conductor機能）

コアコンセプト：また別のAIコーディングツールではなく、ターミナルAI開発ワークフローのコントロールセンターです。

コアデータ

3. インストールと初期設定（5分で開始）

インストール方法

Agent Deckには3つのインストール方法があります。Homebrewが一番手間いらずです：

# 方法1：Homebrew（推奨、macOS / Linux 共通）
brew install asheshgoplani/tap/agent-deck

# 方法2：クイックインストールスクリプト
curl -fsSL https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/install.sh | bash

# 方法3：Go install
go install github.com/asheshgoplani/agent-deck/cmd/agent-deck@latest

最初のセッションを作成

インストールが完了したら、ターミナルで以下を実行します：

# Agent Deck TUIを起動し、project-alphaという名前のセッションを作成
agent-deck session start project-alpha

するとtmuxベースのTUI画面が表示されます。まだAIエージェントを設定していない場合、Agent Deckがセットアップを案内してくれます。

基本的なTUI操作

TUIに入ったら、よく使うナビゲーションショートカットは以下の通りです：

ステータスによるフィルタリング検索（非常に便利）：

グループ内ナビゲーション（v1.7.60+で追加されたAlt+ショートカット、現在のグループ内でのみ移動）：

インテリジェントステータス表示

Agent Deckはインテリジェントなポーリングで各エージェントの状態をリアルタイムに検出します：

待機中のセッションはtmuxステータスバーに直接表示されます：Ctrl+bを押して離し、その後1-6を押すだけで対応する待機セッションに直接ジャンプできます。ステータスバーはこんな風に表示されます：

⚡ [1] frontend [2] api [3] backend

4. コア機能実践

4.1 セッションのFork：1つの機能、複数の実装、互いに干渉しない

ForkはAgent Deckの最も特徴的な機能の1つです。こんなシナリオを想像してください。Claude CodeでAPIインターフェースを設計した後、2つの異なる実装方法を試したいとします。従来の方法なら新しいセッションを開き、要件を最初から説明し直す必要があります。Forkなら、次のようにするだけ：

# TUIでForkしたいセッションにカーソルを置く
# f → クイックFork（自動で名前を生成）
# F → Fork後の名前とグループをカスタマイズ

Forkの核心价值：

• 新しいセッションが親セッションの完全な会話履歴を継承
• Claude / OpenCode / Pi / Codexのネイティブforkに対応（ツール自体のfork機能）
• Fork後にさらにForkでき、アイデアの分岐を自由に探索可能
• 各ブランチは互いに干渉せず、いつでも比較できる

⚠️ 注意：Codexのfork機能にはcodex CLIバージョン ≥ 0.137.0が必要です。

4.2 MCP Manager：設定ファイルに触れずにMCPサービスを管理

MCP（Model Context Protocol）サービスにより、AIエージェントが外部ツール（ウェブ検索、ブラウザ自動化、データベースクエリなど）にアクセスできます。従来の管理方式ではJSON設定ファイルを手動で編集する必要がありましたが、Agent Deckはこれを TUIでの可視化操作にしました：

TUIでmを押してMCP Managerを開く：

MCP設定の場所：~/.config/agent-deck/config.toml

設定例：

[[mcp_servers]]
name = "web-search"
command = "npx"
args = ["-y", "@anthropic/mcp-server-brave-search"]

TUIで設定を完了すると、Agent Deckは自動的に対応するエージェントセッションを再起動して変更を適用します。手動での再起動は不要です。

4.3 Skills Manager：プロジェクトごとにClaude Skillsを管理

Claude Codeユーザー向けに、Agent DeckにはSkills Managerが内蔵されており、プロジェクトごとにClaude Skillsをプール管理できます：

TUIでsを押してSkills Managerを開く（Claudeセッションのみ有効）：

• プール管理：利用可能なスキルリストはプール（~/.config/agent-deck/skills/pool）からのみ提供され、attach/detach操作の予測可能性を確保
• プロジェクトレベルの状態：プロジェクトの状態は.agent-deck/skills.tomlに書き込まれ、スキルファイルは.claude/skillsディレクトリに実体化
• タイプでジャンプ：MCP Managerと同じ名前でのジャンプ操作

これにより、プロジェクトごとに異なるスキルセットを設定できます。例えば：

• project-alpha：web-search + code-reviewスキルをattach
• project-beta：api-testing + docs-generationスキルをattach

4.4 MCP Socket Pool：マルチセッション環境でメモリを85%節約

複数のセッションを同時に実行し、それぞれが同じMCPサービスに接続する場合、メモリ消費は倍増します。Agent Deckの MCP Socket Pool は、Unix Socketを通じて複数のセッションが同じMCPプロセスを共有できるようにします：

# config.tomlで有効化
[mcp]
pool_all = true

効果：

• MCPメモリ使用量を 85〜90%削減
• MCPプロセスがクラッシュした場合、約 3秒以内に自動再接続（再接続プロキシ）
• 上位のエージェントからは完全に透過的で、コードの変更は不要

4.5 グループごとの独立したClaude設定

同じマシンで複数のClaudeアカウント（個人アカウントと仕事用アカウントなど）を管理している場合、Agent Deckはグループごとに異なるClaude認証を設定できます：

# config.toml
[groups."conductor".claude]
config_dir = "~/.claude-work"
env_file = "~/git/work/.envrc"

検索優先度：環境変数 > グループ > 設定ファイル(profile) > グローバル > デフォルト

env_fileはtmux paneを起動する前にロードされ、中のexportがセッション環境の一部になります。異なるAPIキーや異なるClaude作業ディレクトリが必要なシーンで非常に便利です。

5. 上級テクニック：Conductorオーケストレーション

Conductorとは？

Agent Deckのセッション管理が「自動運転」だとしたら、Conductorは「艦隊司令官」です。より高度な抽象化レイヤーとして、Telegram / Slack / Discordを通じてすべてのAIエージェントセッションをリモートで監視・オーケストレーションできます。

5分でTelegram監視を構築

# 1. @BotFatherでTelegram Botを作成し、tokenを取得
# 2. @userinfobotで自分のuser IDを取得

# 3. ウィザードをワンクリックで実行（conductor、bridge daemon、heartbeatを自動設定）
agent-deck conductor setup work --description "Work fleet"

# 4. conductorセッションを起動
agent-deck session start conductor-work

# 5. Telegramでbotに /status を送信

これ以降、すべてのAgent Deckセッションが統一されたconductorセッションによって監視されます：

• 日常的な問題は自動処理
• 重要な事項はスマホにプッシュ通知
• 待機中の作業が放置されて忘れられることがない

Watcher設定：外部イベントでAIエージェントを起こす

能動的な問い合わせ以外にも、Watcherを設定することで、外部イベント（GitHubイベント、Gmail、ntfyプッシュ、会議リマインダーなど）が「チャイムを鳴らして」conductorを起こすことができます。具体的な設定は公式Watcherドキュメントを参照してください。

6. Agent Deck vs その他の比較

7. まとめ

Agent Deckが解決するのは「どのAIコーディングツールが優れているか」という問題ではありません。それは複数のAIツールを使う際に、それらを狂気的沙汰なく協調動作させるにはどうすればいいかという問題です。

コアバリューの振り返り：

1. ワンストップコントロール：1つのターミナルウィンドウですべてのAIエージェントを管理し、タブ地獄から解放
2. セッションFork：既存の会話から新しいアイデアを分岐し、要件を再度説明する必要なし
3. 可視化されたMCP/Skills管理：設定ファイルを手動で編集する必要がなくなる
4. MCP Socket Pool：マルチセッション環境でメモリ消費を大幅に削減
5. Conductorリモート監視：Telegram / SlackでいつでもAIエージェントの状態を把握
6. Git Worktree統合：複数エージェントが同じリポジトリを共同開発、互いに衝突しない

「AIエージェントが多すぎる」問題に直面し始めているなら、Agent Deckはこのニッチ分野で最も成熟したオープンソースソリューションです。しかも更新頻度が非常に高く（v1.9.56 → v1.9.57はわずか4時間間隔）、コミュニティも活発（PR #1408+）で、継続的な注目に値します。

関連リンク：

• 📦 Agent Deck GitHubリポジトリ
• 📋 最新バージョンリリース
• 📖 Conductor完全設定ガイド
• 📖 Watcher設定ガイド
• 💬 Discordコミュニティ

関連記事推薦：

• Aider 完全ガイド — Git-first ターミナルAIプログラミングアシスタント
• CC Switch マルチモデルAIコーディング管理