ccpilot
v0.2.0
Published
ComCodePilot — agente local CLI para devs
Maintainers
Readme
ccpilot — agente local ComCodePilot
CLI que sobe um PTY na sua máquina e conecta de saída à API (/ws/agent). O browser não usa mais ws://localhost — funciona em Linux, Windows, macOS e WSL.
Instalação
npx ccpilot@latest setup # verificar git, API, guia GitHub
npx ccpilot@latest # agente em segundo plano + abre o site
npx ccpilot@latest stop # encerra o agenteFluxo
npx ccpilotgeraagent_tokene abre o painel com?agent_token=...- Você faz login DEV no browser
- O painel chama
POST /api/agent/linke usa o WebSocket da API para o terminal - O agente mantém conexão
wss://<api>/ws/agent?token=<agent_token>
Requisitos
| Item | Obrigatório |
|------|-------------|
| Node.js 18+ | Sim |
| Git | Sim |
| GitHub CLI (gh) | Recomendado |
| Conta ComCodePilot (DEV) | Sim |
| PAT GitHub (scope repo) | Sim — no painel web |
| API acessível da sua máquina | Sim |
Variáveis de ambiente
# Frontend (URL aberta no browser)
export CCPILOT_APP_URL=https://comcodepilot.codecommr.com.br
# API (WebSocket do agente — obrigatório se não for o padrão de produção)
export CCPILOT_API_URL=https://api-comcodepilot.codecommr.com.brEm dev local:
export CCPILOT_APP_URL=http://localhost:3010
export CCPILOT_API_URL=http://localhost:3001Comandos
| Comando | Descrição |
|---------|-----------|
| npx ccpilot | Agente em background + abre o site |
| npx ccpilot stop | Encerra o agente |
| npx ccpilot setup | Diagnóstico + instruções GitHub |
| npx ccpilot --no-open | Só agente em background |
