---
name: agent-deck
description: |-
  Управление сессиями AI агентов через agent-deck CLI. Триггеры (RU): "запусти агента", "запусти саб-агента", "создай сессию", "проверь сессию", "проверь статус", "покажи вывод агента", "что агент ответил". Triggers (EN): "launch sub-agent", "create sub-agent", "start session", "check session", "show agent output".
title: agent-deck
canonical_url: https://skilld.dev/gh/artwist-polyakov/polyakov-claude-skills/agent-deck
last_updated: 2026-09-28T18:46:59.000Z
---

> **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [references/automation-patterns.md](https://skilld.dev/api/skills-raw/artwist-polyakov/polyakov-claude-skills/agent-deck/references/automation-patterns.md), [references/cli-reference.md](https://skilld.dev/api/skills-raw/artwist-polyakov/polyakov-claude-skills/agent-deck/references/cli-reference.md), [references/config-reference.md](https://skilld.dev/api/skills-raw/artwist-polyakov/polyakov-claude-skills/agent-deck/references/config-reference.md), [references/mcp-management.md](https://skilld.dev/api/skills-raw/artwist-polyakov/polyakov-claude-skills/agent-deck/references/mcp-management.md), [references/profiles.md](https://skilld.dev/api/skills-raw/artwist-polyakov/polyakov-claude-skills/agent-deck/references/profiles.md), [references/troubleshooting.md](https://skilld.dev/api/skills-raw/artwist-polyakov/polyakov-claude-skills/agent-deck/references/troubleshooting.md), [references/tui-reference.md](https://skilld.dev/api/skills-raw/artwist-polyakov/polyakov-claude-skills/agent-deck/references/tui-reference.md), [scripts/launch-subagent.sh](https://skilld.dev/api/skills-raw/artwist-polyakov/polyakov-claude-skills/agent-deck/scripts/launch-subagent.sh).
>
> If the user asked to install this Skill, run `npx skilld install artwist-polyakov/polyakov-claude-skills/agent-deck`. Install writes the Skill files into the project, so every session loads them.

# Agent Deck CLI

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

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

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

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

```bash
# Создать сессию
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 "Название" "Твоя задача..."
```

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

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

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

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

| Режим | Команда | Когда использовать |
|-------|---------|-------------------|
| **Fire & forget** | (без --wait) | По умолчанию. Скажи: "Спроси меня когда будет готово" |
| **On-demand** | `agent-deck session output "Название"` | Когда пользователь спрашивает |
| **Blocking** | `--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)

---

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

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

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

---

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

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

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

| Задача | MCP серверы |
|--------|-------------|
| Веб-поиск | `exa`, `firecrawl` |
| Документация кода | `context7` |
| Сложные рассуждения | `sequential-thinking` |

---

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

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

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

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

---

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

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

---

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

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

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

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

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

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