Arquitetura

Como o Cortex funciona

O Cortex é uma extensão do VS Code que integra o OpenCode como runtime agentic (servidor local). O Cortex adiciona a camada de IDE — chat lateral, contexto local do codebase e workflows no estilo Cursor/Windsurf — dentro do seu próprio editor. Os modelos vêm da sua assinatura OpenCode.

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  VS Code UI  │ ←→  │ Cortex Ext.  │ ←→  │  OpenCode    │
│  (Sidebar +  │     │ (TypeScript) │     │  (Server)    │
│   Inline)    │     │              │     │              │
└──────────────┘     └──────────────┘     └──────┬───────┘
                                                  │
                                          ┌───────▼───────┐
                                          │ OpenCode      │
                                          │ models        │
                                          │ (your sub)    │
                                          └───────────────┘

Componentes

• SidebarProvider — gerencia o ciclo de vida do painel de chat, roteamento de mensagens e modos plan/build
• OpenCode Client — cliente HTTP que fala com o servidor local OpenCode
• Context Service — obtém contexto relevante via busca léxica + embeddings
• Inline Completion — fornece sugestões ghost-text no editor
• Plan Store — gerencia planos salvos com checklists para o workflow Plan→Build

Workflow Plan → Build

1. Modo Plan: O Cortex analisa seu pedido e cria um plano estruturado com checklist
2. Aprovação: Você revisa e aprova o plano
3. Modo Build: O Cortex implementa as mudanças passo a passo, atualizando o checklist