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 — chat lateral, contexto local del codebase 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 de mensajes y los modos plan/build
• OpenCode Client — cliente HTTP que habla con el servidor local de OpenCode
• Context Service — obtiene contexto relevante vía búsqueda léxica + embeddings
• 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