O jeito recomendado de instalar é pelo instalador da página de download. Esta página descreve a instalação pelo código-fonte, para quem já usa Node.js e Git.
Estes comandos usam Bash e valem para Linux, macOS e WSL2. Substitua valores entre <...> pelos seus dados; eles não são texto para executar literalmente.
#Obter o código
O repositório do Cockpit ainda é privado: a instalação pelo código precisa de um convite de acesso no GitHub. Com o acesso liberado, clone:
mkdir -p "$HOME/Projetos"
cd "$HOME/Projetos"
git clone https://github.com/gruposaht89/cockpit.git cockpit
cd cockpit
Se já tem o checkout, entre na pasta com o package.json da raiz. Não é necessário usar /DATA/Projetos.
#Instalar e compilar
npm run setup
Esse script executa, em sequência:
npm ci
npm --prefix web ci
npm run build:all
Há duas instalações, raiz e web/, cada uma com lockfile. npm ci substitui o node_modules correspondente pelo definido no lockfile. Não use --omit=dev nesta etapa: TypeScript e Vite são necessários para compilar o checkout. O build gera dist/ e web/dist/.
#Skills incluídas e ativação
A instalação executa postinstall e copia 160 skills do pacote local para
~/.cockpit/skills (ou $COCKPIT_HOME/skills). O pacote inclui instruções,
scripts, referências e licenças, com as revisões das 25 fontes registradas em
third_party/skills/manifest.json. Não precisa de Git ou internet adicional para
copiar as skills. Instalações repetidas preservam arquivos existentes e escolhas
de ativação. Se os scripts npm estiverem desabilitados, o primeiro início do
Cockpit completa essa cópia; também pode executar npm run setup:skills.
Em Configurações → Skills → Adicionar skill, importe SKILL.md, selecione uma
pasta completa (com scripts e referências), cole um link público do GitHub ou
escreva as instruções na própria tela. Links podem apontar para um repositório,
uma pasta ou SKILL.md; quando houver várias skills, escolha qual importar.
Um link direto para SKILL.md inclui apenas esse arquivo. Confira a prévia antes
de adicionar. A importação preserva skills existentes com o mesmo nome e aceita
até 8 MB, 2 MB por arquivo e 256 arquivos. Não executa scripts de instalação.
A opção Disponibilizar esta skill para todos os agentes vem ligada e usa o catálogo compartilhado, inclusive nas próximas consultas de agentes já abertos. Ferramentas externas e credenciais continuam sendo configuradas separadamente. Você pode ativar ou desativar skills tanto nesta tela quanto na Biblioteca.
Em Configurações → Skills ou Biblioteca → Skills, mantenha Disponibilizar skills aos agentes ligado
para descoberta automática e escolha quais skills ficam disponíveis. A chave
geral pausa o catálogo sem perder as escolhas individuais. As preferências ficam
em ~/.cockpit/skill-settings.json. Cada tarefa recebe sugestões pelo papel e
pelo pedido; a ponte oferece cockpit_skills para pesquisa e cockpit_skill para
leitura de instruções e arquivos de apoio. O chat DSH também recebe esse contexto.
Skills escolhidas explicitamente para um integrante continuam sendo sugeridas
quando estão ativas. O papel, o escopo e as permissões da missão prevalecem.
O menu esquerdo também oferece Skills, com busca e uma lista expansível. Arraste uma skill ativa para a conversa de um agente ou clique nela para adicioná-la ao agente em foco. No chat DSH, a seleção aparece acima da mensagem e pode ser removida antes de enviar; no terminal, é inserida uma instrução para revisar antes de pressionar Enter. Essa ação não envia a mensagem automaticamente nem modifica as skills permanentes do integrante. No celular e com teclado, use o clique em vez do arraste. Skills desativadas ficam indisponíveis nessa lista.
A desativação vale nas próximas consultas e entregas de tarefas, inclusive nas conexões MCP já abertas. Não desfaz instruções lidas ou ações iniciadas e não altera catálogos próprios que o usuário configurou diretamente nos CLIs.
Skills estão disponíveis por padrão; ferramentas externas e autenticação têm seus próprios requisitos, mostrados na Biblioteca. NotebookLM precisa de sua CLI e login Google; Strix, Agent Reach, Graphify e RTK precisam das respectivas ferramentas para executar comandos. RTK usa um adaptador do Cockpit com a documentação oficial preservada. GSAP e shadcn são instalados no projeto quando necessários. O primeiro uso do Impeccable pode baixar seu executável.
O pacote também inclui code-review, to-spec e to-tickets, de Matt Pocock,
e as seis skills oficiais de ai-memory para consulta, páginas, continuidade,
mensagens, manutenção e instalação das instruções. As skills de Matt Pocock
usam o rastreador configurado no projeto; ai-memory precisa de seu servidor
em execução e do MCP conectado ao agente. Os guias oficiais de instalação e
conexão MCP acompanham cada skill de memória.
Cada skill com requisitos externos oferece Configurar, com passo a passo, requisitos e links oficiais. A confirmação Já configurei os requisitos desta skill fica salva e é manual: não representa um teste da conexão e não muda a ativação. Em Configurações → Skills, os guias são agrupados por ferramenta; as skills que compartilham uma configuração aparecem dentro do mesmo guia. As ferramentas mostram um resumo do que fazem e quando usar; ao expandir o guia, cada skill também tem seu próprio briefing. A Biblioteca mostra resumos em português para as 160 skills incluídas, e as buscas consideram esses textos. O Context7 tem uma única seção: com chave salva, mostra o status e Gerenciar chave, que abre as opções de alteração e remoção.
Context7 inclui as skills oficiais find-docs e context7-cli. Elas consultam
documentação pela CLI e não exigem MCP. O uso anônimo é permitido; login ou
API key aumentam os limites. Em Configurações → Skills, o usuário pode
acessar o painel Context7, salvar ou remover a API key. A chave é criptografada
no servidor, nunca retorna ao navegador e é aplicada como CONTEXT7_API_KEY
aos novos agentes nativos e DSH. Reinicie agentes existentes para aplicar
alterações. Salvar a chave não verifica a autenticação. Login interativo da CLI
continua sob controle do usuário, no servidor que executa o Cockpit.
anti-ui-slop vem do índice oficial de descoberta da UIZZE, com ZIP validado
pelo SHA-256 publicado. O pacote cobre as 24 fontes GitHub e essa fonte web.
Para manutenção, edite third_party/skills/sources.json e rode
npm run bundle:skills, que busca somente as revisões e o arquivo registrados.
A manutenção requer Git, curl e Python 3; a instalação usa apenas Node.js e o
pacote local. Esse download ocorre na manutenção, não na instalação.
#Iniciar e verificar
Para acesso somente no próprio computador:
node bin/cockpit.js --host 127.0.0.1
Abra http://localhost:4000. Para iniciar pelo script que também aceita conexões de rede:
npm start
Diferença: npm start usa 0.0.0.0 como host padrão; o CLI direto usa 127.0.0.1 quando não há flag nem variável. Use o IP de rede mostrado no terminal, sem presumir endereço fixo.
Em outro terminal:
curl http://127.0.0.1:4000/api/health
A resposta contém ok e ptyBackend. Para terminais completos, espere python-pty ou node-pty; pipe indica fallback sem TTY.
#Encerrar e recuperar
Use Ctrl+C no terminal do servidor. Por padrão, os agentes são preservados pelo host de sessões para reconectar na próxima inicialização. Encerrar o painel não cancela automaticamente o trabalho em curso.
Para também encerrar os agentes ao sair, inicie assim:
npm start -- --stop-agents
Worktrees são preservadas. Reconexão depende de os processos ainda existirem: não significa sobreviver a reboot/desligamento. Missões restauradas ficam pausadas até iniciar/retomar.