Documentação

Usar

Agentes e projetos

#Agentes

Runners padrão: bash, claude, codex, agy e opencode. Runners adicionais podem vir da configuração legada. Instale/autentique somente os escolhidos, conforme as instruções de cada fornecedor. Confira no mesmo usuário e ambiente do servidor:

command -v bash
command -v claude
command -v codex
command -v agy
command -v opencode

Execute as verificações apenas das ferramentas que instalou:

claude --version
codex --version
agy --version
opencode --version

Abra o CLI diretamente e confirme uma interação antes de usá-lo no Cockpit. Após instalar/autenticar, reinicie o servidor e atualize a descoberta de agentes.

Modelos, esforço e contas dependem do runner. O Codex pode fornecer modelos pelo cache local; outros runners usam configuração ou descoberta própria. Não selecione um modelo só porque aparece em um perfil antigo. Delegações preservam runner/modelo dos destinatários configurados pelo usuário.

#Conectar contas nas configurações

Em Configurações → Conexões, selecione Codex, Claude ou Antigravity e clique em Adicionar conta → Entrar no navegador. O CLI precisa estar instalado no servidor, mas não precisa ter uma sessão autenticada. O apelido é opcional e não substitui o login. Use o filtro Todos para encontrar executores ainda não configurados.

Conexões são apresentadas em uma lista com busca e filtros; contas e modelos ficam nos detalhes do provedor escolhido. O controle Ativar provedor decide se ele pode ser usado por novos integrantes, preservando sessões abertas. DeepSeek pode ser conectado por API key. Conectar gateway cadastra nome, URL base, formato OpenAI (Chat Completions ou Responses) e chave opcional; o teste consulta /models, sem inferência paga. Chaves são criptografadas no servidor. Responses pode usar Codex ou DSH; Chat Completions usa DSH. URLs remotas precisam de HTTPS; localhost se refere ao servidor do Cockpit.

Em Configurações → Execução, ative ou desative o DSH para novas sessões. A ativação prepara automaticamente seu diretório isolado quando o harness está instalado. Sem DSH disponível, a interface informa como configurá-lo e permite usar um CLI instalado. Desativar DSH ou um provedor não encerra sessões abertas; novas sessões e reinícios respeitam a configuração. Idiomas ficam em Preferências. Essas escolhas são persistidas em <COCKPIT_HOME>/integrations.json (padrão ~/.cockpit).

  • Codex: abra o link de login e informe o código de dispositivo exibido nas instruções. Esse fluxo também funciona em VPS.
  • Claude: autorize no navegador. Se o CLI solicitar um código, use a opção para enviar a autorização nas configurações.
  • Antigravity: autorize a conta Google. Se o retorno local falhar em uma VPS, copie a URL completa da barra de endereços e cole na opção de redirecionamento manual. O servidor precisa de AGY_OAUTH_CLIENT_ID e AGY_OAUTH_CLIENT_SECRET, ou de ~/.cockpit/agy-oauth.json com clientId e clientSecret, como no Cockpit anterior. O retorno usa uma porta local temporária, state e PKCE, conforme a documentação OAuth do Google.

Cada conta criada usa um diretório exclusivo em ~/.cockpit/profiles/. Após concluir o login, ela entra no pool e fica disponível na seleção de contas dos integrantes. O registro fica em ~/.cockpit/accounts.json; COCKPIT_HOME permite mudar a raiz. As contas do catálogo anterior continuam disponíveis. É possível cancelar um login pendente; sessões expiram após dez minutos.

#Projetos

Abra, prepare ou clone pela interface. Escolha pasta gravável. O seletor trabalha com pastas do servidor, inclusive ao acessar de outro dispositivo. O caminho inicial histórico é /DATA/Projetos; informe seu caminho real em outras instalações.

Preparação manual de projeto novo:

mkdir -p "$HOME/Projetos/meu-app"
cd "$HOME/Projetos/meu-app"
git init
git config user.name "Seu Nome"
git config user.email "seu-email@example.com"
git commit --allow-empty -m "Inicializa projeto"

O commit inicial permite resolver HEAD, necessário para isolamento/revisão. Em repositório existente, confira git status e preserve mudanças em andamento. Clones privados precisam de credenciais Git/SSH já configuradas; o backend desabilita prompts interativos do Git.

A partir do checkout do Cockpit, inicie sobre outro projeto:

node bin/cockpit.js --cwd "$HOME/Projetos/meu-app" --host 127.0.0.1

--cwd define a raiz inicial de projeto e persistência da instância. Não é necessário copiar o Cockpit para cada projeto.