asheshgoplani

agent-deck

@asheshgoplani/agent-deck
asheshgoplani
483
38 forks
Updated 1/18/2026
View on GitHub

Terminal session manager for AI coding agents. Use when user mentions "agent-deck", "session", "sub-agent", "MCP attach", or needs to (1) create/start/stop/restart/fork sessions, (2) attach/detach MCPs, (3) manage groups/profiles, (4) get session output, (5) configure agent-deck, (6) troubleshoot issues, or (7) launch sub-agents. Covers CLI commands, TUI shortcuts, config.toml options, and automation.

Installation

$skills install @asheshgoplani/agent-deck
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Repositoryasheshgoplani/agent-deck
Pathskills/agent-deck/SKILL.md
Branchmain
Scoped Name@asheshgoplani/agent-deck

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions

name: agent-deck description: Terminal session manager for AI coding agents. Use when user says "launch sub-agent", "create sub-agent", "start session", "check session", or needs to manage Claude/AI sessions via CLI. Handles session lifecycle (create/start/stop/restart/fork), MCP attachment, session output retrieval, and parent-child session hierarchies.

Agent Deck CLI

Sub-Agent Launch

Trigger: User says "launch sub-agent", "create sub-agent", or similar.

scripts/launch-subagent.sh "Title" "Prompt" [--mcp name] [--wait]

The script auto-detects current session/profile and creates a child session.

Retrieval Modes

ModeCommandUse When
Fire & forget(no --wait)Default. Tell user: "Ask me to check when ready"
On-demandagent-deck session output "Title"User asks to check
Blocking--wait flagNeed immediate result

Recommended MCPs

Task TypeMCPs
Web researchexa, firecrawl
Code docscontext7
Complex reasoningsequential-thinking

Quick Reference

# Session lifecycle
agent-deck add -t "Name" -c claude /path          # Create
agent-deck add -t "Name" --parent "Parent" /path  # Create as child
agent-deck session start|stop|restart "Name"      # Control
agent-deck session send "Name" "message"          # Send
agent-deck session output "Name"                  # Get response
agent-deck session current [-q|--json]            # Detect current

# MCPs
agent-deck mcp list                               # Available
agent-deck mcp attach "Name" <mcp>                # Attach (restart after)

# Status
agent-deck status                                 # Summary
agent-deck session show "Name"                    # Details

Status: ● running | ◐ waiting | ○ idle | ✕ error

Critical Rules

  1. Flags before arguments: session show -json name ✓
  2. Restart after MCP attach: mcp attach then session restart
  3. Avoid polling from other agents - can interfere with target session

References