Scalix Coder — VS Code Extension

AI-powered coding assistant for Visual Studio Code, powered by the Scalix platform.

Features

Sidebar Chat Panel — Persistent chat interface with streaming AI responses and markdown rendering
Tab Completion — AI-powered inline code suggestions as you type
Inline Chat (Cmd+I) — Edit code in-place with AI assistance
Context-Aware Commands — Explain, Fix, and Refactor code selections
Codebase Search — Symbol-level search across your entire project
Model Picker — Dynamic model selection fetched from your Scalix account
Inline Diff Viewer — See file changes before and after AI modifications
Git Checkpoints — Create and restore checkpoints of your workspace
Session History — Save and restore chat sessions
Status Bar — Real-time model info, connection status, and token usage
Context Bar — Visual indicator of token usage with warning thresholds
Permission Modes — Control tool execution (plan, default, auto, yolo)
Slash Commands — /new, /clear, /model, /mode, /compact, /cost, /attach, /stop, /key, /settings, /term, /help
@-Mentions — @file, @folder, @selection, @terminal, @codebase, @web
Settings Panel — In-chat settings with General, Models, and Tools tabs
IPC Bridge — Connects to the Scalix CLI for full tool access (31 tools)
Open in Terminal — Launch the full Scalix CLI from the extension

Getting Started

1. Install the Extension

Build and install from source:

cd vscode-extension
npm install
npm run build
npm run package

Install the generated .vsix file via VS Code:

Open Command Palette (Cmd+Shift+P)
Run "Extensions: Install from VSIX..."
Select the .vsix file

2. Configure

Open VS Code Settings (Cmd+,)
Search for "Scalix"
Enter your API key (get one at scalix.world)
The default model is scalix-lumio-lite (free tier)

Or set via settings.json:

{
  "scalix.apiKey": "sk_scalix_your_key_here",
  "scalix.baseUrl": "https://api.scalix.world",
  "scalix.model": "scalix-lumio-lite"
}

Commands

Command	Shortcut	Description
Scalix Coder: Open	`Cmd+Shift+L`	Open/focus the chat sidebar
Scalix: New Chat	`Cmd+Shift+N`	Start a new conversation
Scalix: Abort Request	`Cmd+Shift+Esc`	Cancel the current request
Scalix: Open Chat in Editor	`Cmd+Shift+K`	Open chat as an editor tab
Scalix: Open in Terminal	`Cmd+Shift+T`	Launch full CLI in terminal
Scalix: Inline Chat	`Cmd+I`	Edit code in-place with AI
Scalix: Search Codebase	`Cmd+Alt+Shift+F`	Search symbols across project
Scalix: Select Model	—	Choose from available models
Scalix: Explain Selection	—	Explain highlighted code
Scalix: Fix Selection	—	Fix issues in highlighted code
Scalix: Refactor Selection	—	Refactor highlighted code
Scalix: Add File to Context	—	Add current file to chat context
Scalix: Create Checkpoint	—	Save git checkpoint
Scalix: Restore Checkpoint	—	Restore from a checkpoint
Scalix: Re-index Codebase	—	Rebuild the symbol index
Scalix: Toggle Tab Completion	—	Enable/disable inline suggestions
Scalix: Open Settings	—	Open Scalix settings

Right-click on selected code to access:

Scalix: Explain Selection
Scalix: Fix Selection
Scalix: Refactor Selection
Scalix: Inline Chat

Settings

Setting	Default	Description
`scalix.apiKey`	—	Your Scalix API key
`scalix.baseUrl`	`https://api.scalix.world`	API host root (the extension composes the `/v1/ai/...` paths)
`scalix.model`	`scalix-lumio-lite`	Default model
`scalix.permissionMode`	`default`	Tool permission level (plan/default/auto/yolo)
`scalix.maxSteps`	`25`	Max agent steps per request
`scalix.showToolCalls`	`true`	Show tool calls in chat
`scalix.viewMode`	`standard`	Chat view mode (standard/detail/focus)
`scalix.plan`	`free`	Scalix subscription plan
`scalix.cliPath`	—	Custom path to Scalix CLI (auto-detected if empty)
`scalix.completionEnabled`	`true`	Enable AI-powered tab completion
`scalix.completionModel`	—	Model for tab completion (uses default if empty)
`scalix.completionDebounceMs`	`300`	Debounce delay before requesting completion
`scalix.completionMaxTokens`	`256`	Max tokens per completion response
`scalix.completionTemperature`	`0.2`	Temperature for completions
`scalix.completionContextLines`	`50`	Lines of context sent for completion
`scalix.inlineChatMaxTokens`	`4096`	Max tokens for inline chat responses
`scalix.inlineChatTemperature`	`0.3`	Temperature for inline chat
`scalix.inlineChatContextLines`	`30`	Surrounding context lines for inline chat
`scalix.indexerMaxFileSize`	`1048576`	Max file size (bytes) for indexer
`scalix.indexerBatchSize`	`200`	Files indexed concurrently per batch
`scalix.checkpointMax`	`50`	Maximum checkpoints to keep
`scalix.sessionMax`	`200`	Maximum saved chat sessions
`scalix.requestTimeoutSec`	`300`	Request timeout (seconds)
`scalix.ipcTimeoutSec`	`120`	IPC command timeout (seconds)
`scalix.toolResultMaxChars`	`5000`	Max chars shown per tool result

Supported Models

Models are fetched dynamically from your Scalix account. Scalix models use the scalix-lumio-* family — every plan includes scalix-lumio-lite, and higher tiers unlock additional Scalix models as they become available. Use Scalix: Select Model to see the models on your plan.

Development

cd vscode-extension
npm install
npm run watch    # Build with file watching
npm run lint     # Run ESLint

Press F5 in VS Code to launch the Extension Development Host.

Architecture

File	Purpose
`extension.ts`	Extension activation, command registration, watcher setup
`agent-bridge.ts`	Agent implementation with HTTP API and IPC modes
`chat-panel.ts`	Webview provider — generates full HTML/CSS/JS for chat UI
`status-bar.ts`	Status bar items (model, mode, version)
`diff-viewer.ts`	Side-by-side diff viewer for file modifications
`completion-provider.ts`	Inline completion provider for tab suggestions
`inline-chat.ts`	Inline chat (Cmd+I) implementation
`indexer.ts`	Multi-language symbol indexer with file watching
`checkpoints.ts`	Git-based checkpoint create/restore
`session-store.ts`	Chat session persistence

Requirements

VS Code 1.85.0 or later
Scalix API key (scalix.world)
Node.js 18+ (for IPC bridge to CLI)

Scalix Coder

Scalix World