Arquitectura

Cómo funciona Cortex

Cortex es una extensión de VS Code que integra OpenCode como runtime agentico (servidor local). Cortex añade la capa de IDE — panel de chat, contexto local del codebase, Policy Brain y workflows al estilo Cursor/Windsurf — dentro de tu propio editor. Los modelos vienen de tu suscripción de OpenCode.

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

Componentes

• SidebarProvider — gestiona el ciclo de vida del panel de chat, el enrutado, la timeline Parts→rows y los modos plan/build
• OpenCode Client — cliente HTTP del servidor OpenCode local, con watchdog de tools colgados y estado SSE
• Theme engine — aplica temas OpenCode Desktop en el chat (caché del catálogo GitHub, custom ~/.config/opencode/themes, follow tui.json)
• Policy Brain — inyección multicapa de rules/skills/memory/hooks (T0–T3) con loaders Cursor + Cortex
• Context Service — obtiene contexto relevante vía búsqueda léxica + embeddings (hash o MiniLM); las actualizaciones incrementales mantienen el índice coherente
• Inline Completion — proporciona sugerencias ghost-text en el editor
• Plan Store — gestiona planes guardados con checklists para el workflow Plan→Build

Workflow Plan → Build

1. Modo Plan: Cortex analiza tu petición y crea un plan estructurado con checklist
2. Aprobación: Revisas y apruebas el plan
3. Modo Build: Cortex implementa los cambios paso a paso, actualizando el checklist