agent-deck

Agent Deck CLI

Terminal session manager for AI agents. Allows launching, monitoring, and getting results from child Claude sessions.

Launching a sub-agent

Triggers: "launch agent", "launch sub-agent", "launch sub-agent"

Simple launch (CLI commands)

# Создать сессию
agent-deck add -t "Название" -c claude /path/to/workdir

# Создать как дочернюю сессию текущего агента
agent-deck add -t "Название" --parent "Родитель" -c claude /path/to/workdir

# Запустить
agent-deck session start "Название"

Send a task

agent-deck session send "Name" "Your task..."

### Автоматический запуск (скрипт)

```bash
scripts/launch-subagent.sh "Название" "Промпт" [--mcp exa] [--wait]

The script automatically:

• Determines the current session and profile
• Creates a child session
• Waits for Claude initialization
• Sends the prompt

Result retrieval modes

Mode	Command	When to use
Fire & forget	(without --wait)	Default. Say: "Ask me when it's ready"
On-demand	agent-deck session output "Название"	When the user asks
Blocking	--wait	An immediate result is needed

---

Checking status

Triggers: "check session", "check status", "check session"

agent-deck status                      # Все сессии (сводка)
agent-deck session show "Название"     # Детали конкретной сессии
agent-deck session show -json "Название"  # JSON формат
agent-deck session current             # Текущая сессия (в которой работаем)
agent-deck session current --json      # Текущая сессия в JSON

Statuses:

• ● running (running)
• ◐ waiting for input (waiting)
• ○ idle (idle)
• ✕ error (error)

---

Getting the result

Triggers: "show agent output", "what did the agent reply", "show agent output"

agent-deck session output "Название"

---

MCP connection

agent-deck mcp list                        # Доступные MCP серверы
agent-deck mcp attach "Название" exa       # Подключить MCP к сессии
agent-deck session restart "Название"      # ОБЯЗАТЕЛЬНО после подключения!

Recommended MCP

Task	MCP servers
Web search	exa, firecrawl
Code documentation	context7
Complex reasoning	sequential-thinking

---

Session management

# Жизненный цикл
agent-deck session start "Название"
agent-deck session stop "Название"
agent-deck session restart "Название"

# Список всех сессий
agent-deck ls
agent-deck ls -json

# Удалить сессию
agent-deck rm "Название"

---

Important rules

1. Flags before arguments: session show -json name (not session show name -json)
2. After mcp attach required session restart to apply changes
3. Avoid polling results from other agents — this may interfere with the target session
4. Session identification: you can use the name, ID (≥6 characters), or path

---

Usage examples

Launching the research agent

# Создать агента для веб-исследования
agent-deck add -t "Researcher" -c claude --mcp exa /tmp/research
agent-deck session start "Researcher"
agent-deck session send "Researcher" "Найди информацию о последних трендах в AI"

Readiness check

# Проверить статус
agent-deck session show "Researcher"

# Если статус ◐ (waiting) — агент закончил, получить результат:
agent-deck session output "Researcher"