Agent Deck MCP Server

<div align="center"> <!-- agent-deck mark: status dots on Calm Navy --> <img src="site/logo.svg" alt="Agent Deck Logo" width="96">

Agent Deck

Install . Quick Start . Connect your assistant . Docs . Discord . FAQ

</div>

Agent Deck runs all your AI coding agents (Claude Code, Codex, Gemini CLI, OpenCode and more) in one terminal and shows which ones are working, waiting, or done.

https://github.com/user-attachments/assets/e4f55917-435c-45ba-92cc-89737d0d1401

Installation

Works on macOS, Linux and Windows (WSL).

curl -fsSL https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/install.sh | bash

Or with Homebrew:

brew install asheshgoplani/tap/agent-deck

Other ways to install, updates, uninstall and shell completion: Install and update.

Quick Start

cd ~/code/my-project              # any project folder
agent-deck launch . -c claude     # create and start a Claude Code session here
agent-deck                        # open the deck, pick the session, press Enter

The keys you need first:

Key	Action
Enter	Attach to session
Ctrl+Q	Detach from session
n	New session
/	Search
Alt+W	Show me around: what you can do, your agents and sign-in
Alt+N	What's new: this version's highlights and your reports it fixed
?	Full help

More commands and every key: Quick start and keys.

Connect your assistant

Paste this into your assistant (Hermes, OpenClaw, Grok, Claude, ChatGPT, Codex...):

Read https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/docs/assistants/SETUP-PROMPT.md and follow it to connect yourself to agent-deck on my machine. Ask me before each step that changes anything.

It checks agent-deck, connects itself, saves its own config and tests it. Or run agent-deck connect and paste what it prints, or use the Connect page in agent-deck web.

Your assistant can only read your sessions at first (read-only). You choose if it may do more. Details: Connect an assistant.

Documentation

• Guide index: every guide and reference in one list
• Install and update
• Quick start and keys
• Sessions, groups and config: MCP and skills managers, groups, accounts, search, status, forking, archive, feedback
• Worktrees and sandboxes: git worktrees, Docker sandbox
• Conductor and watchers: run a fleet from your phone
• Tools, costs and quotas: supported agents, cost dashboard, agent-deck usage
• Remote machines and the web UI
• FAQ and asking an AI
• CLI reference . Config reference . Troubleshooting
• Contributing and development . CONTRIBUTING.md . CHANGELOG.md

Star History

If Agent Deck saves you time, give us a star! It helps others discover the project.

License

MIT License — see LICENSE

---

<div align="center">

Built with Bubble Tea and tmux

Docs . Discord . Issues . Discussions

</div>