Korp — AI Coding Assistant (Sovereign)

Chat Participant @korp for VS Code — powered by your own self-hosted LLM gateway.

Features

💬 Chat Participant `@korp`

Type @korp in the VS Code Chat panel to talk to your sovereign AI assistant. Context-aware: sends your active file, selection, and workspace skills automatically.

🎙️ Voice Input (Push-to-Talk & VAD)

Record your voice with a single keybinding (Cmd+Shift+K). Powered by a local Whisper STT sidecar — no audio leaves your machine.

Push-to-Talk: hold to record, release to transcribe
Voice Activity Detection (VAD): auto-listen when VS Code has focus

🔊 Text-to-Speech (TTS)

Hear responses read aloud via a local Piper neural voice. Toggle with Korp: Toggle TTS.

🧩 Skills Panel

Extend @korp with markdown skill files. Drop .md files in .korp/skills/ or ~/.korp/skills/ to inject custom system prompts.

Auto-detected on workspace open
Toggle skills on/off from the Activity Bar
Live reload on file changes

🚀 Onboarding Wizard

First launch walks you through:

Gateway URL configuration
Token setup (stored securely in OS keychain)
Voice/STT activation
TTS preferences

Re-run anytime with Korp: Run Onboarding Wizard.

Slash Commands

Command	Description
`@korp /explain`	Explain the selected code or active file
`@korp /fix`	Identify and fix bugs
`@korp /test`	Generate unit tests
`@korp /docs`	Generate documentation

Commands

Command	Keybinding	Description
Korp: Push to Talk	`Cmd+Shift+K`	Start/stop voice recording
Korp: Toggle VAD	—	Enable/disable voice activity detection
Korp: Toggle TTS	—	Enable/disable text-to-speech
Korp: Stop Speaking	—	Interrupt current TTS playback
Korp: Set Gateway Token	—	Store gateway token securely
Korp: Run Onboarding Wizard	—	Re-run first-launch setup
Korp: Toggle Skill	—	Enable/disable a skill
Korp: Refresh Skills	—	Reload skill files
Korp: Toggle Log Level	—	Switch between debug/info

Settings

Setting	Default	Description
`korp.gatewayUrl`	`http://localhost:18789`	OpenClaw gateway URL
`korp.whisperUrl`	`http://localhost:9500`	Whisper STT sidecar URL
`korp.ttsEnabled`	`false`	Enable TTS for responses
`korp.ttsModel`	`~/.korpforge/models/piper/fr_FR-siwis-medium.onnx`	Piper ONNX voice model
`korp.vadEnabled`	`false`	Enable voice activity detection
`korp.logLevel`	`info`	Output channel log level

Requirements

VS Code ≥ 1.93
OpenClaw gateway running (self-hosted, see stack/)
sox — for voice recording (brew install sox / apt install sox)
whisper-server — local Whisper STT sidecar on port 9500
piper (optional) — for TTS (brew install piper or build from source)

Quick Start

Install the extension
The onboarding wizard launches automatically
Configure your gateway URL and token
Type @korp hello! in the Chat panel

Architecture

┌─────────────────────────────────────────┐
│  VS Code                                │
│  ┌─────────┐  ┌──────┐  ┌───────────┐   │
│  │ @korp   │  │ Voice│  │  Skills   │   │
│  │ Chat    │  │ PTT  │  │  Panel    │   │
│  └────┬────┘  └──┬───┘  └─────┬─────┘   │
│       │          │            │         │
│       ▼          ▼            │         │
│  ┌─────────┐  ┌───────┐       │         │
│  │OpenClaw │  │Whisper│       │         │
│  │Gateway  │  │ STT   │       │         │
│  │(SSE)    │  │(local)│       │         │
│  └─────────┘  └───────┘       │         │
│       │                       │         │
│       ▼                       ▼         │
│  ┌─────────┐           .korp/skills/    │
│  │  LLM    │                            │
│  │(self-   │                            │
│  │ hosted) │                            │
│  └─────────┘                            │
└─────────────────────────────────────────┘

Development

cd vscode/
npm install
npm run compile
# Press F5 to launch Extension Development Host

Run tests:

npx vitest run

Korp

korpforge