Scalix Coder

AI-powered coding agent for the terminal and VS Code — built by Scalix World.

Scalix Coder is a full-featured AI coding assistant that runs in your terminal or as a VS Code extension. It connects to the Scalix API (or any OpenAI-compatible endpoint) and gives AI direct access to your codebase through 31 built-in tools — file editing, shell execution, search, git, web access, browser automation, vision, voice input, and more.

Features

• Terminal UI — Rich React/Ink interface with magenta-themed prompt, scrollable chat, streaming responses, and keyboard shortcuts
• VS Code Extension — Sidebar chat panel with inline diffs, tab completion, inline chat (Cmd+I), codebase search, model picker, checkpoints, and session history
• 31 Built-in Tools — Shell, file read/write/edit, search (ripgrep), git, web fetch/search, directory tree, notebooks, browser automation, vision, voice input, sub-agents
• Security Sandbox — Path traversal prevention, symlink detection, command blocklist, injection detection, SSRF protection
• 4 Permission Modes — plan (read-only) / default (ask) / auto (auto-approve) / yolo (full autonomy)
• Context Management — Auto-compression, sliding window, per-model context limits
• Dynamic Model Registry — Models fetched from your Scalix account with exact context windows
• Session Persistence — Save, load, and resume conversations
• Project Intelligence — Auto-detects tech stack, conventions, git context
• Plugin System — Custom tools via .scalix/plugins/
• Custom Commands — Reusable prompts in .scalix/commands/*.md
• Model Routing — Multi-model support with complexity-based routing and fallback
• Cost Tracking — Token usage and budget limits per session/day/month
• Sub-agents — Delegate tasks with isolated tool access
• Git Checkpoints — Create and undo agent-made changes
• Auto-Verification — Automatic build/lint checks after file modifications
• Lifecycle Hooks — Pre/post tool-use hooks via .scalix/hooks.json
• IPC Server — Bridge mode for VS Code extension integration
• Browser Automation — Navigate, click, type, screenshot, and evaluate JS in headless browsers

Quick Start

Install

git clone https://github.com/scalixworld/scalix-coder.git && cd scalix-coder
npm install
sudo npm link

Run

scalix

First launch opens a setup wizard to configure your Scalix API key, endpoint, and models.

Environment Variables

| Variable | Description | | ----------------- | -------------------------------- | | SCALIX_API_KEY | API key (overrides saved config) | | SCALIX_MODEL | Comma-separated model IDs | | SCALIX_BASE_URL | API base URL | | BRAVE_API_KEY | Brave Search API key | | TAVILY_API_KEY | Tavily Search API key |

Headless Mode

scalix run "explain src/agent.ts"

echo "list all TODO comments" | scalix --pipe

scalix run "generate a migration" --output migration.sql --format patch

Commands

| Command | Description | | ------------------ | ---------------------------- | | /help | Show all commands | | /shortcuts | Keyboard shortcuts | | /clear | Reset conversation | | /models | List active models | | /model | Switch model | | /mode | Set permission mode | | /compact | Compress context | | /cost | Token usage & cost | | /budget | Budget status | | /save [name] | Save session | | /load | Resume session | | /index | Scan project files | | /git | Git context | | /memory | Project memory | | /remember <note> | Save a project note | | /replay | Session timeline | | /plugins | Loaded plugins | | /settings | Configure limits | | /setup | Reconfigure API key & models | | /delegate <task> | Run with sub-agent | | /checkpoint | Create git checkpoint | | /undo | Undo last checkpoint | | !<cmd> | Run shell command |

Keyboard Shortcuts

| Key | Action | | ----------------------- | ---------------------------------------- | | Ctrl+C | Interrupt / clear / double-press to quit | | Ctrl+D | Exit (empty input) | | Ctrl+L | Clear screen | | Ctrl+U | Clear input line | | Ctrl+W | Delete last word | | Ctrl+S | Stash/restore prompt | | Tab | Autocomplete commands | | Up/Down | Input history | | Shift+Up / PageUp | Scroll chat up | | Shift+Down / PageDown | Scroll chat down | | Esc | Quit |

Tools

Core

| Tool | Description | | ------------------ | ------------------------------------ | | get_current_time | Current date/time with timezone | | calculate | Safe math expression evaluator | | run_command | Shell execution with security checks | | read_file | File reading with line numbers | | read_file_lines | Read specific line ranges | | write_file | File creation/overwrite | | list_files | Directory listing with glob support |

Code

| Tool | Description | | -------------- | ------------------------------------ | | edit_file | Precise string replacement with diff | | search_files | Regex search via ripgrep | | find_files | Glob-based file finding | | tree | Directory tree visualization |

Git

| Tool | Description | | ------------ | ------------------------------- | | git_status | Branch, changes, recent commits | | git_diff | Staged/unstaged diffs | | git_commit | Stage and commit |

Web

| Tool | Description | | ------------ | --------------------------------------- | | web_fetch | Fetch URLs with SSRF protection | | web_search | Search via Brave, Tavily, or DuckDuckGo |

Browser

| Tool | Description | | -------------------- | ------------------------------------- | | browser_navigate | Navigate to a URL in headless browser | | browser_screenshot | Capture browser page screenshot | | browser_click | Click elements on page | | browser_type | Type text into page elements | | browser_eval | Execute JavaScript in browser context | | browser_get_text | Extract text content from page | | browser_close | Close browser session |

Vision & Voice

| Tool | Description | | ------------- | --------------------------------- | | read_image | Analyze images with vision models | | screenshot | Capture desktop screenshots | | voice_input | Voice-to-text input |

Advanced

| Tool | Description | | ---------------- | --------------------------- | | todo_write | Task tracking | | notebook_edit | Jupyter notebook operations | | monitor | Background process output | | agent | Spawn sub-agents | | add_mcp_server | Register MCP servers |

Configuration

Config is stored in ~/.scalix-coder/config.json.

Limits

| Setting | Default | Description | | ---------------------- | --------- | --------------------------------------------- | | maxSteps | 200 | Tool-call rounds per request | | maxMessages | 200 | History size | | maxContextTokens | 1,000,000 | Context window (tokens) | | compressionThreshold | 0.75 | Auto-compress when context exceeds this ratio | | maxToolResultTokens | 10,000 | Truncate tool results (tokens) | | commandTimeoutMs | 60,000 | Shell command timeout (ms) | | bgCleanupMs | 300,000 | Background process auto-cleanup (5 min) | | readFileMaxSize | 10 MB | Max file size for read operations |

Project Files

| Path | Purpose | | ----------------------- | ----------------------------- | | AGENT.md | Project-specific instructions | | .scalix/memory.json | Conventions & notes | | .scalix/plugins/ | Custom tool plugins | | .scalix/commands/*.md | Custom slash commands | | .scalix/hooks.json | Lifecycle hooks | | .scalix/rules/*.md | Scoped rules | | mcp-services.json | MCP server config |

VS Code Extension

Full-featured sidebar assistant with streaming chat, tab completion, inline chat, inline diffs, codebase search, and checkpoints.

See vscode-extension/README.md for setup and usage.

cd vscode-extension
npm install
npm run build
npm run package    # Creates .vsix file

Development

npm run start        # Run CLI
npm run dev          # Watch mode
npm run test         # Vitest
npm run typecheck    # Type-check
npm run lint         # ESLint
npm run check        # All checks

Architecture

src/
  cli.tsx              Terminal UI (React/Ink)
  headless.ts          Headless/REPL mode
  agent.ts             Core agent loop
  constants.ts         All defaults and configuration constants
  settings.ts          Config management and validation
  sandbox.ts           Security sandbox (path, command, injection)
  context-manager.ts   Token counting & compression
  context-builder.ts   System prompt assembly
  token-counter.ts     Token estimation engine
  tools.ts             Core tools (shell, file, time, calc)
  tools-extra.ts       Code tools (edit, search, find, git)
  tools-web.ts         Web tools (fetch, search, tree, read_file_lines)
  tools-advanced.ts    Advanced tools (todo, notebook, sub-agent, monitor)
  tools-browser.ts     Browser automation (navigate, click, type, eval)
  tools-vision.ts      Vision tools (read_image, screenshot)
  tools-voice.ts       Voice input tool
  tool-helper.ts       Tool definition helper
  tool-selector.ts     Dynamic tool selection
  model-router.ts      Multi-model complexity routing
  cost-tracker.ts      Token/cost tracking with budgets
  sessions.ts          Session persistence
  project-index.ts     Project file scanning & symbol extraction
  project-memory.ts    Convention memory system
  plugins.ts           Plugin auto-discovery and loading
  sub-agent.ts         Sub-agent spawning
  auto-verify.ts       Post-edit build/lint verification
  change-tracker.ts    File modification tracking
  hooks.ts             Lifecycle hook execution
  scoped-rules.ts      Scoped rules engine
  commands.ts          Custom slash commands
  git-context.ts       Git info collection
  git-undo.ts          Checkpoint/undo system
  agent-replay.ts      Session timeline replay
  diff.ts              LCS diff computation
  markdown.ts          Markdown rendering
  safe-math.ts         Safe expression evaluator
  logger.ts            Structured logging
  mcp.ts               MCP server integration
  ipc-server.ts        IPC bridge for VS Code extension
  config.ts            Config helpers

vscode-extension/
  src/extension.ts          Extension activation & command registration
  src/agent-bridge.ts       Agent implementation (HTTP + IPC modes)
  src/chat-panel.ts         Webview chat UI (HTML/CSS/JS)
  src/status-bar.ts         Status bar integration
  src/diff-viewer.ts        Inline diff viewer
  src/completion-provider.ts  AI-powered tab completion
  src/inline-chat.ts        Inline chat (Cmd+I)
  src/indexer.ts            Codebase symbol indexer
  src/checkpoints.ts        Git checkpoint management
  src/session-store.ts      Session persistence

bin/
  scalix.js            CLI entry point

License

Scalix Coder is proprietary software. See LICENSE for the full EULA.

(c) 2024-2026 Scalix World Private Limited. All rights reserved.