# Context0 for VS Code (`contextzero`)

Extensão nativa do VS Code que conecta o Agent / Copilot ao seu **Context0 Core** via MCP HTTP.

Site do produto: [contextzero.tecnologia.dev.br](https://contextzero.tecnologia.dev.br/)

> Este repositório é **público** e contém apenas a extensão VS Code. O Core (servidor) e o monorepo completo permanecem privados.

## O que é

Context0 é um índice pessoal de documentação para agentes e IDEs. Esta extensão:

- Registra um servidor MCP HTTP no VS Code (API nativa)
- Guarda a API key no **Secret Storage** (nunca no VSIX)
- Expõe comandos na paleta (**Ctrl+Shift+P** → `Context0`)

## Pré-requisito

Um **Context0 Core** self-hosted em execução (MCP HTTP + API key). A URL é configurada por você na extensão — não há endpoint embutido neste pacote.

## Instalação

### Opção A — VSIX (Release)

1. Baixe `contextzero-*.vsix` na [página de Releases](https://github.com/thiagovasconcelosti/contextzero-vscode/releases)
2. VS Code → Extensions → **Install from VSIX…**  
   ou: `code --install-extension contextzero-0.1.3.vsix`

### Opção B — Marketplace

Quando publicado: busque **Context0** / `contextzero` no painel de extensões.

### Opção C — Build local

```bash
npm install
npm run package
code --install-extension ./contextzero-0.1.3.vsix
```

## Comandos (Ctrl+Shift+P)

| Comando | Função |
|---------|--------|
| Context0: Configurar URL e API key | Assistente completo |
| Context0: Definir URL do Core | Só a URL base (sem `/mcp`) |
| Context0: Definir / atualizar API key | Secret Storage |
| Context0: Remover API key | Apaga a key salva |
| Context0: Ver status da configuração | URL + key mascarada |
| Context0: Doctor (health do Core) | Health check |
| Context0: Atualizar servidor MCP | Recarrega definições MCP |

## Cliente npm (opcional)

Para configurar outros IDEs (Cursor, Claude, etc.):

```bash
npm i -g contextzero
ctx0 setup --api-key SUA_CHAVE --cursor
```

## Privacidade e segurança

- Sem secrets no código ou no VSIX
- Sem IP/porta hardcoded
- Issues: não publique API keys

## Licença

MIT — ver [LICENSE](LICENSE).

## Links

- Produto: https://contextzero.tecnologia.dev.br/
- Issues: https://github.com/thiagovasconcelosti/contextzero-vscode/issues
- npm client: https://www.npmjs.com/package/contextzero