bin/ Entrypoints cockpit e cockpit-agent
src/cli/ Argumentos, inicialização e encerramento
src/server/ Fastify, rotas, WS, PTY e sessões duráveis
src/core/ Execuções, estados, resultados e evidências
src/persistence/ Stores locais e escrita atômica
src/orchestration/ Despacho, supervisão, dependências e race
src/isolation/ Worktrees, symlinks e configuração
src/review/ Diffs, anotações e revisão
src/adapter/ Eventos e sinais de sessão
src/transcript/ Parsers, saneamento e handoff
src/services/ Projetos, agentes, catálogos, mídia, voz e DSH
src/catalog/ Perfis e contratos dos papéis
src/types/ Contratos TypeScript
web/ React, Vite, CodeMirror e xterm
tests/ Unitários, integração e e2e
scripts/ Geração de relatório
docs/ Especificações, planos, schemas e auditorias
dist/ Backend gerado
web/dist/ Interface gerada
Referências:
docs/README.md.docs/Cockpit.md.docs/ROLE_CONTRACTS.md.docs/COCKPIT_AI_RUNTIME_AND_ROUTING_PLAN.md.docs/COCKPIT_P3_RACE_MODE_AND_FRONTIERS_SPEC.md.docs/COCKPIT_MULTI_PROVIDER_QUOTAS_SPEC.md.docs/COCKPIT_RELEASE_AND_DEPLOYMENT_PLAN.md.docs/COCKPIT_END_TO_END_ACCEPTANCE_PLAN.md.docs/COCKPIT_INVARIANTS_COMPLIANCE_MATRIX.md.docs/COCKPIT_MIGRATION_2026-10-04.md.docs/schemas/worker-result.schema.json.
Auditorias registram o estado na data de produção. Para comportamento atual, confira código, scripts e verificações da revisão instalada.
#Modo de ferramentas DSH
Ao criar ou configurar um integrante com harness DSH, escolha Padrão (chamadas diretas de ferramentas) ou PTC mode (programas que coordenam ferramentas via run_code). O Cockpit carrega o runtime de código do DSH para sessões PTC e mostra o modo no cabeçalho da conversa. Sessões existentes mantêm seu modo; mudar a configuração exige aplicar e reiniciar o integrante.
As permissões são independentes: Somente leitura, Escrita no projeto ou Acesso completo. PTC não amplia o acesso. Acesso completo permite ações fora do projeto conforme as políticas do DSH.
O DSH carrega a ponte MCP do Cockpit automaticamente, tanto em Padrão quanto em PTC, com identidade e autenticação da sessão. Os subagentes internos do DSH ficam desativados para preservar a equipe configurada. Conversa e saída técnica exibem blocos de resposta, ferramentas e erros; blocos de raciocínio não são exibidos nem salvos no histórico do chat.
Ao atualizar uma instalação com sessões DSH antigas, encerre os painéis e reinicie o Cockpit antes de criar novos integrantes. O serviço de sessões antigo não carrega código novo; uma versão sem a ponte atual é recusada ao tentar criar uma sessão DSH. Históricos existentes são preservados.
#Diagnóstico e acesso remoto protegido
Depois de npm run setup, execute npm run doctor (ou cockpit --doctor).
O diagnóstico não inicia o servidor: verifica Node, Git, Bash, escrita no projeto,
build web, o motor de voz e OpenSSL para gerar certificados locais. Os mesmos resultados aparecem em
Configurações → Instalação. Em Conexões, use Testar conexão para validar
os agentes; detectar um arquivo de configuração não comprova autenticação válida.
No Windows, execute o servidor no WSL2; o navegador Windows pode usá-lo como cliente.
O acesso local sem token continua disponível. Clientes pela rede precisam de um convite de pareamento ou token mestre, inclusive para REST e WebSocket. Convites para endereços de rede exigem HTTPS; convites HTTP são apenas para loopback.
Pela interface, abra Configurações → Administração no computador servidor via
localhost. Clique em Gerar certificado e ativar HTTPS (porta padrão 4443),
baixe o certificado público e instale-o como autoridade confiável em cada dispositivo.
O painel mostra os endereços HTTPS disponíveis. Abra o endereço seguro e vá a
Acesso remoto para criar o convite. A ativação usa um segundo listener no mesmo
servidor e mantém missões e terminais; a ponte local dos agentes continua usando
a conexão existente. Certificados e configuração ficam em .cockpit/tls e
.cockpit/https-admin.json; HTTPS é restaurado nos próximos inícios do servidor.
Renovar certificado atualiza o certificado com os IPs atuais e preserva a
autoridade já instalada nos dispositivos. Se outra aplicação usar a porta, escolha
uma porta livre antes de ativar. Se o servidor já iniciou com --tls-cert, ele usa
o certificado fornecido e sua renovação segue essa configuração original.
Como alternativa pela linha de comando, npm run setup:https cria uma autoridade certificadora local
em ~/.cockpit/tls e um certificado com os IPs atuais, localhost e 127.0.0.1.
O comando imprime a linha exata para iniciar com HTTPS, incluindo NODE_EXTRA_CA_CERTS
para que a ponte CLI/MCP dos agentes confie no certificado. Instale somente ca.pem
como autoridade confiável em cada dispositivo/navegador cliente. As chaves privadas
ca-key.pem e key.pem ficam no servidor e nunca devem ser compartilhadas.
A instalação de confiança depende do sistema do dispositivo e não é feita automaticamente.
Se o IP mudar ou o certificado expirar, gere novamente; a autoridade existente é preservada.
Também é possível usar um certificado PEM existente:
npm start -- --host 0.0.0.0 --tls-cert /caminho/certificado.pem --tls-key /caminho/chave.pem
O certificado precisa incluir o endereço usado pelo cliente e 127.0.0.1 para a
ponte local dos agentes; o Node precisa confiar no emissor. As opções equivalentes
são COCKPIT_TLS_CERT e COCKPIT_TLS_KEY. Nunca desative a validação TLS.
A configuração descreve HTTPS direto no Cockpit. Se usar proxy reverso local,
configure também COCKPIT_TOKEN; o proxy deve proteger/encaminhar a autenticação,
pois a conexão do proxy ao backend é local.
Em Configurações → Acesso remoto, informe a URL HTTPS, clique em Verificar endereço e gere um convite para o dispositivo. A verificação confirma que a URL responde pelo mesmo servidor. O modo Acompanhar é somente leitura; Controlar permite tarefas, revisões e terminais. Convites são de uso único, expiram em cinco minutos e a sessão dura 24 horas. Revogue dispositivos no mesmo painel.
Para atualizar, encerre normalmente o servidor (os agentes são preservados), faça
uma cópia de .cockpit e dos arquivos de configuração em ~/.cockpit, atualize o
código e execute npm run setup e npm run doctor antes de iniciar novamente.
Para restaurar, pare o servidor, volte à versão correspondente do código e restaure
as cópias. Não copie o armazenamento enquanto estiver sendo modificado.
#Sugestões de agente com Jev
Em Configurações → Conexões → TypeSafe / Jev, cadastre a chave TypeSafe, ative as sugestões e use Testar Jev. Salvar não faz chamada externa; o teste e as consultas podem consumir créditos. A chave fica cifrada no servidor.
Na missão, abra Andamento → Atividade → Ferramentas da equipe → Sugerir agente para uma tarefa. Informe o resumo e
categoria, confira os candidatos e permita o envio desse contexto. A sugestão
mostra o integrante, probabilidades e confiança. Aplicar sugestão preenche o
destinatário e a mensagem para revisão; enviar continua sendo uma ação separada.
Só entram agentes já abertos e disponíveis. Em falha da TypeSafe, a interface
mostra uma seleção local e seu motivo. Consulte Últimas sugestões para o
histórico. Detalhes: docs/JEV_INTEGRATION.md.
Na tela dos agentes, a barra Jev mostra status, decisões e um interruptor por
missão. Nos modos Dirigido e Autônomo, o Maestro usa Jev ao delegar para um papel
ou auto, entre especialistas disponíveis e autorizados; IDs explícitos preservam o
destinatário. O histórico identifica as delegações do Maestro e a tarefa resultante.
As consultas podem enviar título/descrição e candidatos e consumir créditos. Desativar
Jev ou uma falha do provedor mantém a delegação local. No modo Livre, as consultas são
manuais. Jev não troca o modelo ou runner dos agentes.
Use Conectar agentes na barra Jev para escolher todos os especialistas ou somente alguns integrantes. Essa seleção também funciona sem Maestro, por exemplo com Builder e Explorador, usando a consulta manual. Conectar não inicia tarefas ou consultas.
No menu lateral Missões, clique no lápis ao lado do nome para renomear a missão. Edite ali mesmo e use Salvar nome, Enter ou Cancelar (também Esc). O nome fica salvo e atualiza o título da tela, sem alterar o objetivo ou interromper os agentes.
#Triagem e atenção da missão
As consultas Jev também avaliam intenção, complexidade, risco, ambiguidade, necessidade de internet e limites de somente leitura. A escolha considera os modelos e esforços configurados dos especialistas; a recomendação de ajuste não reinicia nem reconfigura sessões automaticamente. Resultados do JEV, na barra superior de uma missão aberta, mostra a triagem e compara resultados observados de encaminhamentos Jev e locais.
Abra Assistente local na barra superior, Comandos → Abrir assistente local
ou use Alt+O para consultar
Atenção agora: bloqueios, entregas para revisão e recuperação de falhas,
mesmo sem Ollama. Com Ollama configurado, sínteses automáticas evitam consultas
repetidas quando o estado relevante não muda; Gerar resumo agora atualiza
explicitamente. Detalhes e limites em docs/JEV_INTEGRATION.md.
No Antigravity CLI, modelos como gemini-3.8-flash-high já definem o raciocínio.
Em Adicionar agente, alterar Effort seleciona uma variante disponível do mesmo
modelo. A pane usa essa variante sem enviar um --effort conflitante.
#Estado da missão e auditoria avançada
Andamento → Estado da missão mostra o andamento registrado da equipe, tarefas bloqueadas ou com falha, entregas para revisar e agentes aguardando resposta ou indisponíveis. Os botões abrem o terminal, a atividade, as dependências ou a revisão correspondente. Quando a conexão ao vivo cai, a tela informa que os dados são os últimos recebidos.
A auditoria da arquitetura fica em Configurações → Avançado → Auditoria do Cockpit, para desenvolvedores e mantenedores. Alt+C e o comando Abrir auditoria do Cockpit abrem essa mesma área. Atualizar o relatório consulta o laudo salvo e não executa testes.
#Orientação para começar
Comece com orientação oferece o Vibe Coding Toolkit na tela inicial e no espaço de criação: escolha seu momento, leia o guia e prepare um pedido para revisar e enviar à IA. Guias, prompts e templates vêm no pacote, com licença MIT e revisão fixada. Veja Comando: conversa, prévia e versões.
#Escritório da equipe
Escritório, no menu lateral, abre o Habblaud completo dentro do Cockpit: personagens, tarefas, feed, histórico, Meu dia, timelapse, temas e cliente da cidade online. As panes reais aparecem automaticamente; seus terminais e mensagens usam o Cockpit. A visão compacta mantém filtros e lista acessível. A cópia integral MIT está incluída; hooks externos exigem configuração, e o World gratuito depende de conta/lista de espera. Veja Escritório para uso, configuração e limites.