Ocelot
Ocelot (Leopardus pardalis) — felino nativo do Brasil com visão noturna excepcional e precisão cirúrgica na caça. Enxerga bugs que humanos não vêem.
Multi-agent AI code system for VS Code. Ocelot orchestrates specialized agents — Reader, Coder, and Validator — each using the optimal LLM for its role, coordinated by a hybrid orchestrator (deterministic Rust logic + LLM fallback).
This extension is a thin client that connects to the ocelot daemon via JSON-RPC over stdio. All intelligence runs in the Rust nucleus; the extension provides the VS Code integration layer.
Features
- Validation Pipeline — 5-stage pipeline (LSP → Lint → Type Check → Build → Test) scoped to affected files only
- Fix Loops — Automated fix attempts with plateau detection and anti-rewrite guard (max 3 attempts)
- Verification Gate — Pre-commit gate that blocks commits if validation stages don't pass
- Validate on Save — Automatically triggers the validation pipeline when you save a file
- Sidebar — Dedicated activity bar with Validation Results and Fix History views
- Status Bar — Live progress of pipeline stages and fix loop iterations
- Diagnostics — Errors and warnings rendered in VS Code's Problems panel
Commands
Open the Command Palette (Ctrl+Shift+P) and type Ocelot:
| Command |
Description |
Ocelot: Validate |
Run the validation pipeline on modified files |
Ocelot: Fix |
Run the fix loop on current errors |
Ocelot: Gate Check |
Run the pre-commit verification gate |
Ocelot: Configure |
Open .ocelot.toml configuration |
Ocelot: Start Daemon |
Start the ocelot daemon |
Ocelot: Stop Daemon |
Stop the ocelot daemon |
Ocelot: Restart Daemon |
Restart the ocelot daemon |
Requirements
ocelot binary installed and available in PATH (or configured via ocelot.daemonPath)- A
.ocelot.toml file in the workspace root (auto-generated on first run via ocelot init)
Settings
| Setting |
Default |
Description |
ocelot.daemonPath |
"ocelot" |
Path to the ocelot binary |
ocelot.autoStart |
true |
Auto-start daemon when a workspace with .ocelot.toml is opened |
ocelot.validateOnSave |
true |
Run validation pipeline on file save |
ocelot.gate.enabled |
false |
Enable pre-commit verification gate |
How It Works
VS Code Extension (thin client)
│
│ JSON-RPC over stdio
▼
┌─────────────────────────────┐
│ OCELOT NUCLEUS │
│ │
│ Orchestrator (Hybrid) │
│ ├── Reader (Haiku) │
│ ├── Coder (Opus) │
│ └── Validator (Sonnet) │
│ │
│ Context Engine │
│ ├── ProjectMap (LSP + TS) │
│ ├── SemanticIndex (local) │
│ └── ContextAssembler │
│ │
│ Validation Pipeline │
│ └── Fix Loop Engine │
└─────────────────────────────┘
The extension:
- Spawns
ocelot serve as a child process
- Communicates via JSON-RPC over stdio
- Intercepts file saves and notifies the daemon
- Renders diagnostics from the pipeline in the Problems panel
- Shows progress in the status bar and sidebar views
Release Notes
0.1.0
Initial release — daemon lifecycle, validation pipeline, fix loops, gate checks, sidebar views, and validate-on-save.
