Usar

Comando: conversa, prévia e versões

Criar, no menu lateral, abre o modo Comando do projeto: a conversa com a equipe de um lado e o resultado do outro. Num projeto sem missão, escreva a ideia em O que você quer criar?. Começar a criar abre uma configuração simples de IA e modelo; Mais opções de criação mostra a configuração da equipe. A ideia vira o objetivo da missão.

#O pedido

  • Escreva como falaria com alguém. Com a conversa vazia, o Cockpit sugere pedidos prontos.
  • O campo mostra o agente, o modelo e o esforço. Trocar um deles reinicia só aquele agente, e a troca fica bloqueada enquanto ele executa um pedido.
  • Automático começa os pedidos sozinho; em Manual, você confirma cada um.
  • Corrida: duas IAs fazem a mesma tarefa, cada uma na sua cópia do projeto; você compara as entregas, com a prévia de cada uma, e escolhe. Em pedidos de visual, o próprio campo sugere ligar a corrida.
  • O + adiciona imagens e arquivos do computador, arquivos do projeto e links. Colar imagens e arrastar arquivos também funciona. São até dez arquivos por pedido, de até 8 MB cada; vídeos não são aceitos. Imagens funcionam com o Codex e o Claude Code. Um arquivo do projeto vai como cópia, para uma edição posterior não mudar o que foi enviado.
  • Textos longos colados viram um cartão que você pode remover.
  • Comece com / para mandar um comando direto ao CLI do agente, sem virar tarefa. Ver todos no menu do agente abre o menu nativo dele. /new, /clear e /reset passam pela confirmação Iniciar do zero.
  • Quando o agente pergunta algo no terminal, como confiar na pasta, a conversa mostra a pergunta e oferece Responder no terminal.
  • A saída do terminal aparece como um cartão de atividade dentro da conversa, sem as bordas e os rodapés do CLI. Abrir terminal completo continua à mão.
  • Com quatro pedidos ou mais, aparece a busca no histórico.

#Guia de criação com IA

Guia de criação com IA, na tela inicial e acima da conversa, traz o Vibe Coding Toolkit (licença MIT, revisão fixada, incluído no Cockpit, sem depender do GitHub). Escolha um caminho, descreva o objetivo e prepare um pedido para revisar e enviar. Nada é escolhido sozinho, e o rascunho fica salvo por projeto e missão. O guia traz receitas: instalar ferramentas ou serviços só acontece quando você envia o pedido ao agente.

#Resultado e prévia

Ver resultado abre o painel do resultado, com Visualização, Versões, Mapa e Salvar cópia. O painel lembra se ficou aberto em cada projeto e avisa Novo resultado quando a prévia muda com ele fechado. No celular, alterne entre Conversa e Resultado.

Visualização prepara o projeto sozinha:

  • Projetos web Node: usa npm run dev, ou npm run start quando não há dev, numa porta livre. Sites estáticos: abre os arquivos; se só houver o script build, executa uma vez.
  • Se faltar dependência, o Cockpit não instala nada por conta própria: Pedir ajuda ao agente envia o diagnóstico.
  • A prévia passa pelo próprio endereço do Cockpit, com atualização ao vivo (HMR), também quando você acessa de outro aparelho. Você não escolhe localhost, IP ou porta.
  • Projetos Expo mostram QR code e link para abrir no celular, na mesma rede, e Abrir no emulador Android ou Abrir no simulador iOS (num Mac), quando instalados no computador do Cockpit.
  • Opções avançadas guarda a escolha do servidor, a pasta de saída, o armazenamento local opcional e os registros.

A prévia roda isolada: o projeto não lê a página, os cookies nem o armazenamento do Cockpit. Nela, localStorage vale só até recarregar; cookies de login do projeto, IndexedDB e service workers não funcionam. Para testar esses recursos, abra o servidor do projeto direto.

#Selecionar elemento

Ative Selecionar elemento e clique em qualquer parte da prévia, inclusive na visualização ao vivo. O próximo pedido leva o seletor, o texto e a versão que você via. A seleção dá contexto à IA; ela não muda o código sozinha.

#Versões

Antes de cada pedido feito pelo Comando, o Cockpit salva uma versão "Antes de: …". Em Versões:

  • compare antes e agora com o divisor arrastável ou lado a lado (projetos com build são montados numa pasta à parte, sem tocar nos seus arquivos);
  • veja os arquivos novos, removidos e alterados;
  • restaure: o estado atual é guardado antes.

São até 50 versões por projeto. Ficam de fora .env, credenciais conhecidas, dependências e saídas como dist e build. Dados externos, processos e serviços não voltam junto. A restauração é recusada enquanto há uma execução ativa no projeto.

#Verificação

Depois de cada entrega de um agente, o Cockpit roda os scripts typecheck e test do projeto. Se algo falhar, a tarefa volta ao agente com o fim do log, até duas vezes. Nenhum agente aprova uma entrega com verificação falhando ou ainda rodando; você pode aprovar depois de ver a falha. Projeto sem esses scripts aparece como não verificado, nunca como aprovado. Configure em .cockpit/verify.json ou desligue com COCKPIT_VERIFY=0.

#Referências, decisões e mapa

Salve referências (links) e decisões do projeto: elas acompanham novos pedidos e a continuação com outra IA. O Mapa mostra os arquivos e as relações de imports e assets; abra um arquivo para ver a origem. Markdown e imagens PNG, JPEG e WebP abrem sem sair do projeto.

#Salvar cópia

Salvar cópia guarda uma cópia estável da prévia, servida pelo próprio Cockpit, com link fixo. Não é hospedagem pública nem domínio: a cópia funciona enquanto o Cockpit estiver ligado, com as regras de acesso dele, e não muda quando o código muda.

#Continuar com outra IA

Escolha outro agente conectado da missão e toque em Levar a conversa. Ele recebe o objetivo, as decisões, as referências, os arquivos, as verificações, as pendências e o trecho recente. Credenciais comuns são removidas, e o agente de origem continua disponível.

#Medidor de contexto

No cabeçalho do Claude e do Codex, a barra mostra quanto do contexto já foi usado, com aviso em 60% e 75%. Nova sessão com resumo guarda um resumo na memória do projeto e abre uma sessão limpa.