Transparent IDE sidecar for the Kotro Proxy Engine — a local LLM gateway with streaming semantic cache, PII redaction, and context compression for OpenAI and Anthropic APIs.
Works in VS Code, Cursor, and other VS Code–compatible editors.
Features
- Zero-config sidecar — spawns the native proxy binary on startup
- Semantic SSE cache — faster repeat prompts;
X-KortoLabs-Cache: HITon cache hits - Status bar — live cache result and compressor bytes saved (polls every 5s)
- Operator dashboard — open from the status bar (
http://127.0.0.1:9090/dashboard) - Isolated telemetry —
/metricsand/dashboardbind to loopback by default, separate from LLM traffic - Context-aware cache keys —
window_nstrategy prevents false cache hits in multi-turn agent loops
Screenshots
Status bar

Dashboard

Install
- Install from the Marketplace (Install above), or:
code --install-extension kortosystems.kortolabs-proxy-engine - Reload the window. The sidecar starts automatically.
- Point your AI client at
http://localhost:8080/v1(OpenAI-compatible base URL).
Quick start (Cursor / VS Code)
-
Set your provider API key in the environment or your agent config.
-
Configure the extension (optional):
Setting Default Maps to kortosystems.listenAddr:8080KORTO_LISTEN_ADDRkortosystems.metricsAddr127.0.0.1:9090KORTO_METRICS_ADDRkortosystems.upstreamUrlhttps://api.openai.comKORTO_UPSTREAM_URLkortosystems.enableCachetrueKORTO_ENABLE_CACHEkortosystems.enableRedactiontrueKORTO_ENABLE_REDACTIONkortosystems.enableCompressiontrueKORTO_ENABLE_COMPRESSIONkortosystems.enableMetricstrueKORTO_ENABLE_METRICS -
Click the Kotro item in the status bar to open the dashboard.
Commands
| Command | Description |
|---|---|
| Korto: Open Dashboard | Opens the local operator UI |
| Korto: Show Proxy Logs | Opens the extension output channel |
Architecture
IDE agent → localhost:8080/v1/* (LLM proxy — may bind 0.0.0.0 in cluster mode)
Operator → 127.0.0.1:9090/dashboard (telemetry — loopback only by default)
Other install channels
- npm:
npm install -g @kortosystems/proxy-engine - Homebrew:
brew tap ramairwing/tap && brew install kortolabs-proxy - GitHub Releases: ramairwing/kotro-proxy-engine
Documentation
Full engine docs, threat model, and observability spec: github.com/ramairwing/kotro-proxy-engine
License
MIT — Kortosystems