Back to Details

agent-deck

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Agent Deck CLI

Agent Deck CLI

Менеджер терминальных сессий для AI агентов. Позволяет запускать, контролировать и получать результаты от дочерних Claude сессий.
AI Agent的终端会话管理器。可用于启动、控制并获取子Claude会话的结果。

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

启动子Agent

Триггеры: "запусти агента", "запусти саб-агента", "launch sub-agent"
触发词： “启动Agent”、“启动子Agent”、“launch sub-agent”

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

简单启动（CLI命令）

bash
undefined
bash
undefined

Создать сессию

Создать сессию

agent-deck add -t "Название" -c claude /path/to/workdir
agent-deck add -t "Название" -c claude /path/to/workdir

Создать как дочернюю сессию текущего агента

Создать как дочернюю сессию текущего агента

agent-deck add -t "Название" --parent "Родитель" -c claude /path/to/workdir
agent-deck add -t "Название" --parent "Родитель" -c claude /path/to/workdir

Запустить

Запустить

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

Отправить задачу

Отправить задачу

agent-deck session send "Название" "Твоя задача..."
undefined
agent-deck session send "Название" "Твоя задача..."
undefined

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

自动启动（脚本）

bash
scripts/launch-subagent.sh "Название" "Промпт" [--mcp exa] [--wait]
Скрипт автоматически:
  • Определяет текущую сессию и профиль
  • Создаёт дочернюю сессию
  • Ждёт инициализации Claude
  • Отправляет промпт
bash
scripts/launch-subagent.sh "Название" "Промпт" [--mcp exa] [--wait]
脚本自动执行以下操作：
  • 识别当前会话和配置文件
  • 创建子会话
  • 等待Claude初始化
  • 发送提示词

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

结果获取模式

РежимКомандаКогда использовать
Fire & forget(без --wait)По умолчанию. Скажи: "Спроси меня когда будет готово"
On-demand
agent-deck session output "Название"
Когда пользователь спрашивает
Blocking
--wait
Нужен немедленный результат
模式命令使用场景
即发即弃(不带--wait)默认模式。可提示：“完成后通知我”
按需获取
agent-deck session output "Название"
用户主动询问时使用
阻塞模式
--wait
需要立即获取结果时使用

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

检查状态

Триггеры: "проверь сессию", "проверь статус", "check session"
bash
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)
触发词： “检查会话”、“检查状态”、“check session”
bash
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"
bash
agent-deck session output "Название"
触发词： “显示Agent输出”、“Agent回复了什么”、“show agent output”
bash
agent-deck session output "Название"

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

MCP连接

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

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

推荐MCP服务器

ЗадачаMCP серверы
Веб-поиск
exa
, 
firecrawl
Документация кода
context7
Сложные рассуждения
sequential-thinking
任务MCP服务器
网页搜索
exa
, 
firecrawl
代码文档
context7
复杂推理
sequential-thinking

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

会话管理

bash
undefined
bash
undefined

Жизненный цикл

Жизненный цикл

agent-deck session start "Название" agent-deck session stop "Название" agent-deck session restart "Название"
agent-deck session start "Название" agent-deck session stop "Название" agent-deck session restart "Название"

Список всех сессий

Список всех сессий

agent-deck ls agent-deck ls -json
agent-deck ls agent-deck ls -json

Удалить сессию

Удалить сессию

agent-deck rm "Название"

---
agent-deck rm "Название"

---

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

重要规则

  1. Флаги перед аргументами: 
    session show -json name
    (не 
    session show name -json
    )
  2. После mcp attach обязательно 
    session restart
    для применения изменений
  3. Избегать polling результатов из других агентов — это может мешать целевой сессии
  4. Идентификация сессии: можно использовать название, ID (≥6 символов) или путь
  1. 参数前加标志位：
    session show -json name
    （而非
    session show name -json
    ）
  2. 执行mcp attach后必须执行
    session restart
    以应用更改
  3. 避免轮询其他Agent的结果——这会干扰目标会话
  4. 会话识别：可使用名称、ID（≥6个字符）或路径

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

使用示例

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

启动研究型Agent

bash
undefined
bash
undefined

Создать агента для веб-исследования

Создать агента для веб-исследования

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

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

检查完成状态

bash
undefined
bash
undefined

Проверить статус

Проверить статус

agent-deck session show "Researcher"
agent-deck session show "Researcher"

Если статус ◐ (waiting) — агент закончил, получить результат:

Если статус ◐ (waiting) — агент закончил, получить результаты:

agent-deck session output "Researcher"
undefined
agent-deck session output "Researcher"
undefined