Agent Deck
Terminal session manager for AI coding agents. One TUI for Claude, Gemini, OpenCode, Codex, and more.
What is Agent Deck?
Agent Deck is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to terminal session manager for ai coding agents. one tui for claude, gemini, opencode, codex, and more.
Terminal session manager for AI coding agents. One TUI for Claude, Gemini, OpenCode, Codex, and more.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Terminal session manager for AI coding agents. One TUI for C
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx agent-deckConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Agent Deck
Agent Deck is a terminal-based session manager (TUI) for AI coding agents that lets you run, fork, monitor, and orchestrate multiple Claude, Gemini, OpenCode, Codex, and Aider sessions side by side from a single interface. It handles MCP server pooling (saving 85–90% memory vs. per-session processes), Docker sandbox isolation, git worktree management, cost tracking, and remote SSH-based agent fleets, plus a conductor orchestration layer for webhook- and Telegram-driven automation. Developers who juggle multiple long-running agent tasks use it to avoid context-switching overhead and keep their AI workflows organized in one place.
Prerequisites
- macOS, Linux, or Windows via WSL2
- Go 1.24+ if building from source (not required for the binary installer)
- At least one coding agent installed: Claude Code, Gemini CLI, OpenCode, Codex CLI, or Aider
- Docker (optional) for sandboxed session isolation
- An MCP-compatible coding agent as the underlying session runtime
Install Agent Deck
Run the automated install script, or use Homebrew on macOS. The script downloads and places the binary on your PATH.
curl -fsSL https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/install.sh | bash
# Or via Homebrew:
brew install asheshgoplani/tap/agent-deckVerify the installation
Check that agent-deck is available and see available commands.
agent-deck --version
agent-deck --helpConfigure Agent Deck
Agent Deck reads its configuration from ~/.config/agent-deck/config.toml. Create this file to set your preferred Claude config directory, enable MCP socket pooling, and configure cost tracking.
[claude]
config_dir = "~/.claude"
[pool_all]
enabled = true
[costs]
retention_days = 90Add a session and open the TUI
Add your project directory as an Agent Deck session using Claude as the agent backend, then launch the TUI.
agent-deck add /path/to/your/project -c claude
agent-deckLaunch the web interface
For browser-based monitoring of your sessions, start the built-in HTTP UI.
agent-deck web
# Accessible at: http://127.0.0.1:8420Agent Deck Examples
Client configuration
Agent Deck configuration file at ~/.config/agent-deck/config.toml showing key options.
{
"mcpServers": {
"agent-deck": {
"command": "agent-deck",
"args": ["mcp"]
}
}
}Prompts to try
Example Agent Deck CLI commands and TUI keyboard shortcuts.
- Run: agent-deck add . -c claude -m "Refactor the authentication module"
- Fork a session: Press 'f' in the TUI to create a quick fork of the current session
- Toggle MCP servers: Press 'm' in the TUI, then Space to enable/disable individual servers
- View cost dashboard: Press '$' to see today's token usage and spend
- Search across all sessions: Press 'G' for global conversation search
- Open a container shell: Press 'T' on a Docker-sandboxed sessionTroubleshooting Agent Deck
Sessions show as 'stopped' immediately after creation
Verify that the underlying agent binary (claude, gemini, opencode, etc.) is installed and on your PATH. Run 'which claude' or the equivalent to confirm. Agent Deck needs the agent CLI available to spawn sessions.
MCP socket pooling is not reducing memory usage
Ensure 'pool_all = true' is set in config.toml. Pooling only applies to MCP servers that support shared socket connections. Check the MCP panel (press 'm') to see which servers are pooled vs. per-session.
Docker sandbox mode fails to start sessions
Confirm Docker Desktop or the Docker daemon is running ('docker ps'). Set 'default_enabled = true' and 'mount_ssh = true' under the [docker] section in config.toml to allow agent access to SSH credentials inside the container.
Frequently Asked Questions about Agent Deck
What is Agent Deck?
Agent Deck is a Model Context Protocol (MCP) server that terminal session manager for ai coding agents. one tui for claude, gemini, opencode, codex, and more. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Agent Deck?
Follow the installation instructions on the Agent Deck GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Agent Deck?
Agent Deck works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Agent Deck free to use?
Yes, Agent Deck is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Agent Deck Alternatives — Similar Developer Tools Servers
Looking for alternatives to Agent Deck? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Agent Deck in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Agent Deck?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.