DimCode

English

简体中文

English

简体中文

Appearance

DimCodePlan · Agent in your terminal

A multi-model coding agent with sessions, safe approvals, and ACP editor integrations.

Getting Started
CLI Reference
SDK & Plugins

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).

SDK & Plugins

Build embedded agents with @archships/dim-agent-sdk and official plugin packages.

DimCode is a multi-model CLI and TypeScript SDK for coding agents, ACP editor integrations, and plugin-driven workflows.

Quick Start ​

Desktop App ​

DimCode Desktop 0.2.4 is available for macOS and Windows:

Install ​

bash
npm install -g dimcode@latest
# 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, connect, models, approvals, MCP, plugins).
  • /connect: connect a provider (or add a custom / local provider).
  • /models: pick a model.
  • /approvals: set tool approvals (auto, normal, or strict).
  • 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
  • MCP servers: ~/.dimcode/mcp.json
  • Tool settings: ~/.dimcode/tools.json
  • Sessions/cache: ~/.dimcode/dimcode/cache.json
  • State store: ~/.dimcode/dimcode/state/

For a full breakdown, 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 Plugins (Ctrl+P → Plugins or /plugins).

MCP servers ​

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

Common workflows ​

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

# One-shot prompt without interactive fallback
dim --no-interaction "Review this repo and propose a refactor plan"

# One-shot prompt from stdin
echo "Review this code" | dim

# Authenticate Next API OAuth
dim auth next-api-oauth

# Editor integration (ACP)
dim acp

See ACP guide: /acp.

For embeddable agent runtime work, see SDK guide: /sdk.

Need help? ​

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