Agent Deck

Agent Deck CLI

Менеджер терминальных сессий для AI агентов. Позволяет запускать, контролировать и получать результаты от дочерних Claude сессий.

Запуск суб-агента

Триггеры: "запусти агента", "запусти саб-агента", "launch sub-agent"

Простой запуск (CLI команды)

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

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

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

# Отправить задачу
agent-deck session send "Название" "Твоя задача..."

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

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

Скрипт автоматически:

• Определяет текущую сессию и профиль
• Создаёт дочернюю сессию
• Ждёт инициализации Claude
• Отправляет промпт

Режимы получения результата

| Режим | Команда | Когда использовать |

|-------|---------|-------------------|

| Fire & forget | (без --wait) | По умолчанию. Скажи: "Спроси меня когда будет готово" |

| On-demand | agent-deck session output "Название" | Когда пользователь спрашивает |

| Blocking | --wait | Нужен немедленный результат |

Проверка статуса

Триггеры: "проверь сессию", "проверь статус", "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

Статусы:

• ● работает (running)
• ◐ ждёт ввода (waiting)
• ○ простаивает (idle)
• ✕ ошибка (error)

Получение результата

Триггеры: "покажи вывод агента", "что агент ответил", "show agent output"

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

MCP подключение

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

Рекомендуемые MCP

| Задача | MCP серверы |

|--------|-------------|

| Веб-поиск | exa, firecrawl |

| Документация кода | context7 |

| Сложные рассуждения | sequential-thinking |

Управление сессиями

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

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

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

Важные правила

• Флаги перед аргументами: session show -json name (не session show name -json)
• После mcp attach обязательно session restart для применения изменений
• Избегать polling результатов из других агентов — это может мешать целевой сессии
• Идентификация сессии: можно использовать название, ID (≥6 символов) или путь

Примеры использования

Запуск исследовательского агента

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

Проверка готовности

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

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