Agent Deck
Your AI agent command center
Install . Quick Start . Features . Conductor . Docs . Discord . FAQ
Agent Deck is mission control for your AI coding agents. Running Claude Code on ten projects, OpenCode on five more, another agent somewhere in the background? One terminal shows every session — running, waiting, or done — and one keystroke switches between them. Groups, search, forking, git worktrees, cost tracking, and a phone-controlled conductor keep a whole fleet manageable.
https://github.com/user-attachments/assets/e4f55917-435c-45ba-92cc-89737d0d1401
Contributing: start here
agent-deck is actively maintained by Ashesh, and it welcomes both contributors and co-maintainers. PRs here don't sit: every incoming PR is validated (applied, built, tested) within about a day, and good ones merge in the next release batch. Recent releases have shipped dozens of community fixes.
Beyond one-off PRs, we're looking for 1-2 regular co-maintainers: people who want to own an area (a tool integration, the TUI, the web view, CI) and help triage and review. The validation pipeline does the heavy lifting; maintainers steer.
To get started:
- Read CONTRIBUTING.md: how the pipeline works, what makes a PR land fast, and the house rules.
- Contributing with an AI agent? Point it at .github/INTAKE.md, the machine-readable intake spec — or the contributor workflow in the agent-deck skill, which walks an agent (or you) through building, testing, and shaping a clean PR.
- Comment on an issue before starting work so we can tell you if someone (human or agent) is already on it.
- Look for issues labeled
good first issue: curated to be small and self-contained.
Looking for something specific to work on? docs/ROADMAP.md lists ideas and follow-ups that are real but not yet scheduled.
If you've had a couple of PRs land here and want to help steer, open an issue titled "maintainer: your area". We'd love the help.
Installation
Works on: macOS, Linux, Windows (WSL)
curl -fsSL https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/install.sh | bash
Then run: agent-deck
Homebrew
brew install asheshgoplani/tap/agent-deck
Go
go install github.com/asheshgoplani/agent-deck/cmd/agent-deck@latest
From Source
git clone https://github.com/asheshgoplani/agent-deck.git && cd agent-deck && make install
agent-deck uninstall # Interactive uninstall
agent-deck uninstall --keep-data # Remove binary only, keep sessions
See Troubleshooting for full details.
agent-deck completion <bash|zsh|fish> prints a completion script for commands and subcommands (agent-deck se<Tab> → session, agent-deck session st<Tab> → start/stop), plus live resource names where it matters — agent-deck remote update <Tab> offers your configured remotes, agent-deck session set-parent <Tab> <Tab> offers session titles at both positions, and agent-deck -p <Tab> offers your profiles.
# bash
echo 'source <(agent-deck completion bash)' >> ~/.bashrc
# zsh
echo 'source <(agent-deck completion zsh)' >> ~/.zshrc
# fish
agent-deck completion fish > ~/.config/fish/completions/agent-deck.fish
Open a new shell (or re-source the config file) afterwards.
Quick Start
agent-deck # Launch TUI
agent-deck add . -c claude # Add current dir with Claude
agent-deck session fork my-proj # Fork a supported session
agent-deck session send my-proj --message-file task.md # Send a multiline prompt
agent-deck session ref my-proj reviewer # Type a reference to my-proj into reviewer (not sent)
agent-deck session remove my-proj # Remove stopped/errored session from registry (transcripts preserved)
agent-deck mcp attach my-proj exa # Attach MCP to session
agent-deck skill attach my-proj docs --source pool --restart # Attach skill + restart
agent-deck web # Start web UI on http://127.0.0.1:8420
This is the beginning of the README. Read the rest at the original. Read the full README ↗
