Skip to content

About

Terminal session manager for AI coding agents. One TUI for Claude, Gemini, OpenCode, Codex, and more.

Topics

Resources

Contributing

Security policy

Stars

1.3k stars

Watchers

6 watching

Forks

Latest commit

 

History

4,606 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

agent-deck-overview-web.mp4

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

Star History

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

Star History Chart

License

MIT License — see LICENSE


Built with Bubble Tea and tmux

Docs . Discord . Issues . Discussions

About

Terminal session manager for AI coding agents. One TUI for Claude, Gemini, OpenCode, Codex, and more.

Topics

Resources

Contributing

Security policy

Stars

1.3k stars

Watchers

6 watching

Forks

Releases

Packages

Used by

Contributors

Languages