DimCode

English

简体中文

English

简体中文

Appearance

DimCodePlan · Agent · Debug in your terminal

A multi-model coding agent with sessions, tools, and safe approvals.

Getting Started
CLI Reference

Beautiful TUI

A modern terminal UI built with Vue.

Multi-session Workspaces

Keep multiple threads per project; sessions are grouped by cwd and easy to switch.

Tool Approvals

Granular control over tool execution—stay safe by default.

Providers & Models

Built-in providers (OpenAI, OpenRouter, etc.), local providers (Ollama / LM Studio), and custom endpoints.

ACP Compatible

Run ACP server mode for editor integrations (e.g., Zed).

Record / Replay

Record and replay TUI events, plus snapshots/logs for debugging.

DimCode is a multi-model CLI coding agent for developers comparing Claude Code, Codex, OpenCode, and Cursor workflows.

Quick Start ​

Install ​

bash
npm install -g dimcode
# pnpm add -g dimcode
# yarn global add dimcode
# bun add -g dimcode

Run ​

bash
dim
# or: npx dimcode

Configure credentials ​

  • Press Ctrl+P → Connect Provider (or type /connect) to add API-key providers (OpenAI / OpenRouter / etc.).

First minute in the TUI ​

  • Ctrl+P: command palette (sessions, settings, models, approvals, tool settings).
  • /connect: connect a provider (or add a custom / local provider).
  • /models: pick a model.
  • /approvals: set tool approvals (auto or all).
  • Shift+Enter: new line; Enter: send; Ctrl+O: expand/collapse tool calls & thinking.

Where your data is stored ​

By default DimCode stores local state under ~/.dimcode/:

  • Config: ~/.dimcode/config.json
  • Sessions/cache: ~/.dimcode/dimcode/cache.json
  • State store: ~/.dimcode/dimcode/state/

For a full breakdown (including tools.json and XDG rules), see: /config.

You can relocate it with:

  • DIMCODE_HOME (base directory)
  • DIMCODE_STATE_DIR (state store directory)

Optional integrations ​

Web search (Serper) ​

WebSearch needs a Serper API key. Configure it in Tool Settings (Ctrl+P → Tool Settings or /tool-settings).

MCP servers ​

Configure MCP servers in MCP Settings (Ctrl+P → MCP Settings or /mcp-settings).

Common workflows ​

bash
# One-shot prompt (tools auto-approved)
dim exec "Review this repo and propose a refactor plan"

# Start local API server and open the web GUI
dim server --open

# Start GUI dev server (repo only, requires bun)
dim gui

# Editor integration (ACP)
dim acp

See ACP guide: /acp.

Need help? ​

  • dim --help prints commands and flags.
  • dim --debug enables diagnostics and writes ./dimcode-debug.log by default.