A ponte cockpit-agent usa contexto injetado pelo servidor, que também adiciona bin/ ao PATH dos painéis. Execute dentro de terminal iniciado pelo Cockpit e associado a uma missão:
cockpit-agent list
cockpit-agent tasks
cockpit-agent task builder "Implementar a validação do formulário"
cockpit-agent delegate reviewer "Revisar formulário" --description "Confira os arquivos alterados e o contrato; entregue achados com arquivo e linha."
cockpit-agent send <ID_DO_PAINEL> "Implementação pronta para revisão"
cockpit-agent wait <ID_DA_TAREFA>
cockpit-agent result <ID_DA_EXECUCAO> completed "Descreva entrega e verificações realmente executadas"
| Ação | Uso |
|---|---|
list | Painéis da missão. |
tasks | Tarefas da missão. |
task <papel> <título> | Cria tarefa sugerindo papel. |
delegate <painel-ou-papel> <título> [--description <contexto>] | Delega dentro dos vínculos/limites. Descrição é um único argumento entre aspas, no final. |
send <painel> <mensagem> | Mensagem ao integrante. |
wait <tarefa> | Aguarda in-review, complete, failed ou blocked; examine o estado retornado. |
inspect <execução> | Consulta workspace, baseline e revisão com diff persistido de uma entrega da missão. |
review <execução> <approved|changes_requested|rejected> <justificativa> | Maestro, Revisor, Verificador ou Segurança registra decisão com evidências sobre entrega de outro agente; não aceita revisão da própria execução. |
result <execução> <estado> <resumo> | Estados: completed, blocked, failed, cancelled. |
Use completed quando os critérios da tarefa estiverem atendidos; blocked para impedimento, failed para falha e cancelled para cancelamento autorizado. Resultado de execução, revisão e conclusão da tarefa são etapas distintas. Escape adequadamente texto externo antes de passá-lo ao shell.
No MCP, cockpit_wait permanece pendente até uma entrega, bloqueio ou falha. As verificações de transporte acontecem dentro da ponte, sem retornar estados intermediários ao modelo. O cancelamento da chamada encerra a espera sem cancelar o trabalho do especialista. Novas sessões Codex recebem mcp_servers.cockpit.tool_timeout_sec=86400 (24 horas); sessões já abertas precisam reconectar a ponte e carregar a nova configuração. Outros clientes MCP devem permitir esperas longas ou renovar seu timeout ao receber notificações de progresso.
cockpit_team inclui os contratos dos papéis presentes e dos autorizados para criação autônoma. cockpit_delegate aceita expectedDeliverable, acceptanceCriteria, allowedFiles e dependencies para registrar o contrato de cada etapa. O especialista recebe seu workspace e baseline, tarefa atual, entregáveis e proibições explícitas. Nos modos Dirigido/Autônomo, só o Maestro delega; especialistas comunicam necessidades com cockpit_send. O Arquiteto trabalha em leitura e entrega desenho ao Maestro para o Builder implementar. cockpit_inspect e cockpit_review conectam a revisão da equipe ao gate existente: uma entrega completed continua em in-review até uma decisão registrada. Não há aprovação automática pelo relato do executor. Os contratos orientam os agentes; não constituem isolamento de escrita no runner nem prova automática de atendimento aos critérios.