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 — painel de chat, contexto local do codebase, Policy Brain 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, o encaminhamento, a timeline Parts→rows e os modos plan/build
• OpenCode Client — cliente HTTP do servidor OpenCode local, com watchdog de tools presos e estado SSE
• Theme engine — aplica temas OpenCode Desktop no chat (cache do catálogo GitHub, custom ~/.config/opencode/themes, follow tui.json)
• Policy Brain — injeção multicamada de rules/skills/memory/hooks (T0–T3) com loaders Cursor + Cortex
• Context Service — obtém contexto relevante via busca léxica + embeddings (hash ou MiniLM); atualizações incrementais mantêm o índice coerente
• 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