DimAgent
Sign upDownload DimAgent

DimAgent

One agent. Everywhere.

An agent runtime — one command to start, every model at your disposal. Terminal, scripts, editor, desktop. Local-first, grows with your project.

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

Desktop App

Native desktop app for macOS, Windows, and Linux with the same powerful features.

DimAgent is a multi-model CLI and desktop coding agent with ACP editor integrations.

Quick Start

Desktop App

DimAgent Desktop 0.9.32 is available for macOS, Windows, and Linux:

Install

npm install -g dimcode@latest
# pnpm add -g dimcode
# yarn global add dimcode
# bun add -g dimcode

Run

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, approve-for-me, or normal).
  • Shift+Enter: new line; Enter: send; Tab: switch AGENT / PLAN; Ctrl+O: background-work panel.
  • /tui: switch between the fullscreen and scrollback forms — see the "Fullscreen TUI" and "Scrollback TUI" pages.

Where your data is stored

By default DimAgent stores local state under ~/.dimcode/v2/:

  • Storage: ~/.dimcode/v2/dimcode.sqlite
  • MCP servers: ~/.dimcode/v2/mcp.json
  • Credentials: ~/.dimcode/v2/credentials/

For a full breakdown, see the config page.

You can relocate it with:

  • DIMCODE_HOME (base 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

# One-shot prompt (default full-access policy)
dim exec --policy full-access "Review this repo and propose a refactor plan"

# Read-only one-shot prompt
dim exec --policy read-only "Review this repo without making changes"

# One-shot prompt with verification
dim exec --verify "pnpm test" "Review this repo and propose a refactor plan"

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

# Authenticate with DimAgent OAuth
dim auth login

# Editor integration (ACP)
dim acp

See ACP guide.

Need help?

  • dim --help prints commands and flags.