Configuração
Ajustes do VS Code
Configure o Cortex nas Configurações do VS Code (pesquise “Cortex”). Os ajustes ficam no namespace cortex.* — não são um config.json do projeto.
| Ajuste | Padrão | Descrição |
|---|---|---|
cortex.opencodeBinary | "opencode" | Caminho para o binário da CLI OpenCode |
cortex.opencodePort | 4096 | Porta local para opencode serve |
cortex.agent | "build" | Agente primário OpenCode padrão (ex.: build, plan) |
cortex.providerID | "opencode" | Id do provedor OpenCode preferido |
cortex.modelID | "big-pickle" | Id do modelo preferido dentro desse provedor |
cortex.modelMode | "auto" | Seleção de modelo: auto / turbo / manual |
cortex.routing.useAllConnectedProviders | false | Se true, Auto/Turbo pode usar qualquer provedor conectado no OpenCode; se false, só cortex.providerID |
cortex.context.topK | 8 | Número de chunks de contexto local injetados por prompt |
cortex.context.maxChars | 12000 | Máximo de caracteres de contexto recuperado por prompt |
cortex.context.embeddings | "hash" | Backend de embeddings: hash (offline) ou minilm |
cortex.context.chunkMode | "symbols" | Modo de divisão do índice: symbols (LSP) ou lines |
cortex.locale | "en" | Idioma da UI do Cortex (independente do idioma do VS Code) |
Modelos via OpenCode
O Cortex usa o OpenCode como provedor agentic. Você escolhe entre os modelos disponíveis na sua assinatura OpenCode. A cobrança do OpenCode é gerenciada fora do Cortex e não tem relação com a licença do Cortex.
- Conectar — Use Cortex: Connect Provider ou Cortex: Manage Tokens / Logins para autenticar no OpenCode
- Seletor de modelo — Escolha qualquer modelo disponível na sua conta OpenCode pelo chat
- Padrões — Defina cortex.providerID, cortex.modelID e cortex.modelMode nas Configurações do VS Code
O OpenCode também pode usar sua própria configuração (por exemplo ~/.config/opencode/opencode.json) para permissões de agente e padrões. Isso é configuração do OpenCode, separada dos ajustes do Cortex no VS Code.
Fontes de contexto
O Cortex coleta contexto automaticamente de:
- Arquivo ativo — o arquivo que você está editando
- Seleção — texto destacado
- Busca léxica — correspondência por palavras-chave no projeto
- Embeddings — embeddings hash por padrão; MiniLM opcional para código relacionado
- Rules / memory — arquivos de rules e memory em .cortex
- @ mentions — arquivos, pastas, terminais e agentes pelo chat