coderix

Coderix

An open-source AI coding agent for the terminal and desktop — a project for research and learning.

Coderix is an AI coding agent that runs in your terminal or as a desktop app. It can read, write, and edit files, execute shell commands, search code, and more — all through natural-language conversation. One core engine powers several front ends: an Ink/React terminal UI (TUI), an Electron desktop app (React DOM + Monaco + xterm), a VS Code extension, and TypeScript / Python SDKs.

Purpose & Scope

Coderix is an independent, open-source project for research and learning — a study of how LLM coding agents are built: agent loops, tool execution, context management, permissions, and multi-agent orchestration.

• It is not affiliated with, endorsed by, or sponsored by Anthropic. "Claude Code" is referenced for comparison only; Coderix is not a product of Anthropic.
• It is meant for research, education, and personal experimentation.
• Supported providers: Anthropic, DeepSeek, and any OpenAI-compatible endpoint — bring your own key.

Repository Layout

Coderix is a pnpm monorepo:

Quick Start

Prerequisites

• Node.js >= 22
• pnpm — the repository is a pnpm workspace
• An API key from Anthropic, DeepSeek, or OpenAI

Install

The ./install.sh installer supports several scopes. Run it from the repo root:

git clone https://github.com/AgenticMatrix/coderix.git
cd coderix

./install.sh --local      # CLI only
./install.sh --desktop    # Desktop app only
./install.sh --all        # Both CLI + Desktop

When to use --reinstall: the desktop app runs the pre-bundled packages/coderix-desktop/dist/main/index.cjs. A plain --desktop only installs dependencies, so a source change (e.g. a fix in coderix-core) won't take effect until the Electron bundle is rebuilt. After git pull — or after editing any packages/coderix-* source — rebuild with:

./install.sh --reinstall --desktop
# or, lighter (no dependency wipe):
pnpm --filter @coderix/desktop build

One-shot remote install

curl -fsSL https://raw.githubusercontent.com/AgenticMatrix/coderix/main/install.sh | bash

This installs coderix from the npm registry (the default path). For development, clone the repo and use the --local / --desktop flags above.

Development

Coderix ships several interfaces backed by the same core engine:

# TUI (terminal) version
pnpm run dev:cli

# Desktop (Electron) version
pnpm run dev:desk

# Desktop — one-click launcher, auto-frees port 5173
./start_desk.sh

# VS Code extension
pnpm run dev:vscode

Other useful scripts: pnpm run build (core + cli), pnpm run build:all (+ vscode), pnpm run typecheck, pnpm test.

Configure

# First-time setup wizard
coderix setup

# Or manually edit ~/.coderix/settings.json

Start Coding

# Interactive session
coderix

# One-shot query
coderix --print "Explain the agent loop in coderix-core"

# Switch model
coderix --model
coderix -m "deepseek/deepseek-v4-pro"

Features

• Beautiful TUI — Built with Ink + React 19, full terminal rendering
• Multi-Provider — Anthropic (Claude), DeepSeek, OpenAI-compatible endpoints
• 15+ Tools — read, write, edit, bash, grep, glob, web-fetch, web-search, task management, todo
• Streaming Tool Queue — Tools enqueue and execute as they are parsed from the LLM stream, with bounded concurrency (default 32)
• Streaming — Real-time text, thinking, and tool-use streaming via ContentBlock events
• Agent Loop — Autonomous multi-turn reasoning with tool call execution
• Permission System — plan / ask / auto modes with risk-level classification
• Context Management — Token budget tracking and automatic compaction
• Hook System — Extensible lifecycle hooks
• Skills — Pluggable skill modules
• Session Management — Checkpoint, resume (--resume / --continue), fork sessions
• Model Picker — Interactive terminal model selection (coderix --model / coderix setup)
• Desktop App — Electron desktop client with Monaco editor, xterm terminal, and source control
• VS Code Extension — Coderix inside your editor
• SDKs — TypeScript and Python SDKs for programmatic access

Keyboard Shortcuts

Configuration

Edit ~/.coderix/settings.json:

{
  "model_list": [
    {
      "model": [
        {
          "name": "deepseek-v4-pro",
          "price": {
            "input": 3,
            "cache_read_input": 0.025,
            "output": 6,
            "currency": "CNY",
            "unit": 1000000,
            "concurrency": 500,
            "max_context": 1000000
          }
        },
        {
          "name": "deepseek-v4-flash",
          "price": {
            "input": 1,
            "cache_read_input": 0.02,
            "output": 2,
            "currency": "CNY",
            "unit": 1000000,
            "concurrency": 2500,
            "max_context": 1000000
          }
        }
      ],
      "provider": "deepseek",
      "base_url": "https://api.deepseek.com/anthropic",
      "auth_token_env": "YOUR_DEEPSEEK_API_KEY"
    },
    {
      "model": [
        "claude-sonnet-2025",
        "opus-4.8"
      ],
      "provider": "anthropic",
      "base_url": "https://api.anthropic.com",
      "auth_token_env": "YOUR_ANTHROPIC_API_KEY",
      "price": {
        "input": 3,
        "output": 15,
        "currency": "USD",
        "unit": "1M tokens"
      }
    },
    {
      "model": [
        "gpt-5",
        "gpt-5-mini"
      ],
      "provider": "openai",
      "base_url": "https://api.openai.com/v1",
      "auth_token_env": "YOUR_OPENAI_API_KEY"
    }
  ],
  "default_model": "deepseek/deepseek-v4-pro",
  "max_tool_concurrency": 32,
  "theme": "dark"
}

CLI Reference

License

Apache 2.0 — see LICENSE.