Architecture

Comment fonctionne Cortex

Cortex est une extension VS Code qui intègre OpenCode comme runtime agentic (serveur local). Cortex ajoute la couche IDE — chat latéral, contexte local du codebase et workflows façon Cursor/Windsurf — dans votre propre éditeur. Les modèles viennent de votre abonnement OpenCode.

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

Composants

• SidebarProvider — gère le cycle de vie du panneau de chat, le routage des messages et les modes plan/build
• OpenCode Client — client HTTP qui parle au serveur OpenCode local
• Context Service — obtient le contexte pertinent via recherche lexicale + embeddings
• Inline Completion — fournit des suggestions ghost-text dans l'éditeur
• Plan Store — gère les plans sauvegardés avec checklists pour le workflow Plan→Build

Workflow Plan → Build

1. Mode Plan: Cortex analyse votre demande et crée un plan structuré avec checklist
2. Approbation: Vous examinez et approuvez le plan
3. Mode Build: Cortex implémente les changements étape par étape en mettant à jour la checklist