Instalação

Da Marketplace do VS Code

1. Abra o VS Code (ou um fork compatível)
2. Vá em Extensões (Ctrl+Shift+X / Cmd+Shift+X)
3. Pesquise por Cortex Agent
4. Instale cortex-labs.cortex-agent

code --install-extension cortex-labs.cortex-agent

Do Open VSX

Para VSCodium, Cursor, Windsurf e outros clientes Open VSX: open-vsx.org

ovsx install cortex-labs.cortex-agent

Do VSIX

Baixe o .vsix nos GitHub Releases e então:

code --install-extension cortex-agent-<version>.vsix

Primeira execução

1. Crie ou use uma conta OpenCode em opencode.ai — aí está a cobrança de IA. O Cortex não tem cadastro próprio.
2. Instale a CLI do OpenCode e garanta que esteja no PATH (ou configure cortex.opencodeBinary). No Windows, o Cortex procura opencode.exe.
3. Instale o Cortex e abra o chat (barra de status ou Ctrl/Cmd+Alt+C) — abre como painel de editor à direita. A pasta do projeto é opcional; sem ela, o Cortex usa o diretório home para perguntas gerais.
4. Conclua o onboarding (ou abra Connect): Get API key → colar → Save. O Cortex grava o auth.json local do OpenCode mesmo se o servidor ainda não estiver pronto. Modelos mais fortes em Models.
5. Escolha um modelo (ou deixe Auto) e comece a conversar

Requisitos

• VS Code 1.100+ (ou um fork compatível)
• Uma conta / assinatura OpenCode (a única conta de IA — sem cadastro Cortex)
• OpenCode CLI ≥ 1.18.0 no PATH (ou cortex.opencodeBinary)
• O build final v1.0.0 expira ~6 meses após a data de release (183 dias; cortex.beta.expirationDate). Depois, instala um VSIX mais recente nos GitHub Releases, ou define cortex.beta.enabled como false.