artwist-polyakov/polyakov-claude-skills

Agent Deck CLI

Gerenciador de sessões de terminal para agentes de IA. Permite lançar, controlar e obter resultados de sessões filhas do Claude.

Lançando um Sub-Agente

Gatilhos: "lance um agente", "lance um sub-agente", "launch sub-agent"

Lançamento Simples (Comandos CLI)

# Criar uma sessão
agent-deck add -t "Nome" -c claude /caminho/para/workdir

# Criar como sessão filha do agente atual
agent-deck add -t "Nome" --parent "Pai" -c claude /caminho/para/workdir

# Iniciar
agent-deck session start "Nome"

# Enviar tarefa
agent-deck session send "Nome" "Sua tarefa..."

Lançamento Automático (script)

scripts/launch-subagent.sh "Nome" "Prompt" [--mcp exa] [--wait]

O script automaticamente:

• Determina a sessão e perfil atuais
• Cria uma sessão filha
• Aguarda a inicialização do Claude
• Envia o prompt

Modos de Obtenção de Resultado

Modo	Comando	Quando usar
Fire & forget	(sem --wait)	Padrão. Diga: "Me pergunte quando estiver pronto"
Sob demanda	agent-deck session output "Nome"	Quando o usuário perguntar
Bloqueante	--wait	Resultado imediato necessário

---

Verificando Status

Gatilhos: "verifique a sessão", "verifique o status", "check session"

agent-deck status                      # Todas as sessões (resumo)
agent-deck session show "Nome"         # Detalhes de uma sessão específica
agent-deck session show -json "Nome"   # Formato JSON
agent-deck session current             # Sessão atual (na qual estamos trabalhando)
agent-deck session current --json      # Sessão atual em JSON

Status:

• ● executando (running)
• ◐ aguardando entrada (waiting)
• ○ ocioso (idle)
• ✕ erro (error)

---

Obtendo Resultado

Gatilhos: "mostre a saída do agente", "o que o agente respondeu", "show agent output"

agent-deck session output "Nome"

---

Conexão MCP

agent-deck mcp list                        # Servidores MCP disponíveis
agent-deck mcp attach "Nome" exa           # Anexar MCP à sessão
agent-deck session restart "Nome"          # OBRIGATÓRIO após anexar!

MCPs Recomendados

Tarefa	Servidores MCP
Busca web	exa, firecrawl
Documentação de código	context7
Raciocínio complexo	sequential-thinking

---

Gerenciamento de Sessões

# Ciclo de vida
agent-deck session start "Nome"
agent-deck session stop "Nome"
agent-deck session restart "Nome"

# Listar todas as sessões
agent-deck ls
agent-deck ls -json

# Remover sessão
agent-deck rm "Nome"

---

Regras Importantes

1. Flags antes de argumentos: session show -json nome (não session show nome -json)
2. Após mcp attach é obrigatório session restart para aplicar mudanças
3. Evitar polling de resultados de outros agentes — isso pode interferir na sessão alvo
4. Identificação da sessão: pode usar nome, ID (≥6 caracteres) ou caminho

---

Exemplos de Uso

Lançando um agente de pesquisa

# Criar um agente para pesquisa web
agent-deck add -t "Pesquisador" -c claude --mcp exa /tmp/pesquisa
agent-deck session start "Pesquisador"
agent-deck session send "Pesquisador" "Encontre informações sobre as últimas tendências em IA"

Verificando conclusão

# Verificar status
agent-deck session show "Pesquisador"

# Se o status for ◐ (aguardando) — o agente terminou, obtenha o resultado:
agent-deck session output "Pesquisador"