Khaos AI Agent — VS Code Extension

Chat with your Khaos AI Agent directly from VS Code. This extension connects to the agent's Responses protocol endpoint and supports real-time SSE streaming for token-by-token output.

Features

• 🔮 Sidebar chat panel — Always available in the activity bar
• 📝 Editor panel — Open as a full editor tab via command palette
• ⚡ Real-time streaming — SSE support for word-by-word responses
• 🎨 Beautiful dark UI — Purple accent theme matching the Khaos brand
• ⚙️ Configurable — Server URL, model name, and streaming toggle
• 🔄 Auto-refresh — Webview updates when settings change

Prerequisites

1. Python 3.10+ with the agent dependencies installed:

   pip install -r requirements.txt
   

2. The Khaos AI Agent running locally:

   python main.py
   

   The agent starts on http://localhost:8088/.

Installation

From VSIX

code --install-extension khaos-ai-agent-0.1.0.vsix

Or in VS Code: Extensions → ⋯ → Install from VSIX…

Development

cd vscode-extension
npm install
npm run compile

Press F5 to launch the Extension Development Host, then:

• Click the Khaos AI icon in the activity bar, or
• Ctrl+Shift+P → Khaos AI: Open Chat

Settings

How It Works

The extension sends POST /responses requests to the agent server using the OpenAI Responses protocol format:

{
  "model": "echo",
  "input": "Hello world!",
  "stream": true
}

When streaming is enabled, the response arrives as Server-Sent Events with delta events for each word. The chat UI renders these tokens in real-time as they arrive.

Build VSIX

Open a new terminal (outside of any Python venv) and run:

cd vscode-extension
npm install
node gen-media.js
npm run compile
npx vsce package --no-dependencies --allow-missing-repository

Or use the provided build script:

# Windows
build.cmd

# PowerShell
powershell -NoProfile -ExecutionPolicy Bypass -File build.ps1

This produces khaos-ai-agent-0.1.0.vsix ready for distribution.

Project Structure