Architecture

Comment fonctionne Cortex

Cortex est une extension VS Code qui intègre OpenCode comme runtime agentic (serveur local). Cortex ajoute la couche IDE — panneau de chat, contexte local du codebase, Policy Brain 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, la timeline Parts→rows et les modes plan/build
• OpenCode Client — client HTTP du serveur OpenCode local, avec watchdog d’outils bloqués et statut SSE
• Theme engine — applique les thèmes OpenCode Desktop dans le chat (cache catalogue GitHub, custom ~/.config/opencode/themes, follow tui.json)
• Policy Brain — injection multi-niveaux rules/skills/memory/hooks (T0–T3) avec loaders Cursor + Cortex
• Context Service — obtient le contexte pertinent via recherche lexicale + embeddings (hash ou MiniLM) ; les mises à jour incrémentales gardent l’index cohérent
• 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