contextzero

Context0 é o seu índice pessoal de documentação para agentes e IDEs.

O pacote contextzero é o client: instala skills, rules, plugins e a ligação MCP no Cursor, Claude, VS Code e outros — conectando-os ao Context0 Core (servidor self-hosted que você sobe à parte).

O que resolve

• Consultar docs de libs/APIs no seu índice, em vez de depender só do training data
• Ingerir documentação oficial por URL (o Core faz o crawl; o agente não precisa baixar página a página)
• Configurar vários IDEs/agentes com um único comando de setup

Pré-requisito

Um Context0 Core já em execução (Docker/API + MCP HTTP), com API key configurada.

Defina a URL do Core via variável de ambiente ou flag — nunca deixe secrets no repositório.

export CONTEXT0_URL=https://seu-core.exemplo
export CONTEXT0_API_KEY=sua-chave

Instalação

npm i -g contextzero

O comando CLI é ctx0.

Setup (escolha os alvos)

# interativo — marca quais IDEs/CLIs instalar
ctx0 setup --api-key "$CONTEXT0_API_KEY"

# ou só os que quiser
ctx0 setup --api-key "$CONTEXT0_API_KEY" --cursor --claude

# todos
ctx0 setup --api-key "$CONTEXT0_API_KEY" --all

Alvos: cursor, claude, codex, copilot, vscode, opencode, universal.

URL do Core (se não estiver em CONTEXT0_URL):

ctx0 setup --url "$CONTEXT0_URL" --api-key "$CONTEXT0_API_KEY" --cursor

Comandos úteis

| Comando | Função | |---------|--------| | ctx0 setup / ctx0 install | Instala skills, rules, plugins e MCP nos alvos | | ctx0 update | Re-sincroniza assets nos alvos já instalados | | ctx0 doctor | Checa URL, API key e health do Core | | ctx0 mcp | Ponte MCP stdio → Core (IDEs sem MCP HTTP) |

Fluxo típico no agente

1. Ler: resolve-library-id → query-docs
2. Adicionar docs por URL: uma chamada ingest-docs (o Core crawla)
3. Trecho colado sem site: submit-candidate

O que este pacote não inclui

O Core (servidor, banco, crawl, IA da rotina diária) fica no repositório/Docker do projeto — não neste npm.

Licença

MIT