DimAgent
Sign upDownload DimAgent

Getting Started

Prerequisites

  • A real terminal (macOS Terminal, iTerm2, Windows Terminal, etc.) is recommended for the best TUI experience.
  • A recent Node.js is recommended if you install via npm/pnpm/yarn.
  • The desktop app does not require a local Node.js runtime.

Desktop App

Download DimAgent Desktop 0.9.32:

CLI Install

For the current CLI version number see dimcode on npm.

npm install -g dimcode@latest

Other package managers:

# pnpm
pnpm add -g dimcode

# yarn
yarn global add dimcode

# bun
bun add -g dimcode

Run

dim
# or: npx dimcode

One-shot execution prints to stdout and uses full-access by default. Add --policy read-only or --policy workspace-write when a narrower run is enough:

dim exec "Review this repo and propose the next change"
dim exec --policy read-only "Review this repo without making changes"
cd /path/to/repo && dim exec --policy workspace-write "Run a focused code review"
echo "Review this code" | dim exec --stdin

Verify

dim --version
dim

DimAgent can be configured entirely inside the TUI:

  1. Open the command palette: Ctrl+P
  2. Choose Connect Provider (or type /connect)
  3. Set API key / base URL
  4. Choose a model: /models
  5. Set tool approvals: /approvals (auto, approve-for-me, or normal)

Tip: For local providers like Ollama or LM Studio, you usually don't need an API key, but you do need to add model IDs (or fetch them) in the Connect Provider flow.

Then run:

dim

For where settings are stored and how paths are resolved, see the config page.

Useful in-app commands

Command palette

Press Ctrl+P for quick access to:

  • Sessions (switch/list/create)
  • Settings / Connect Provider
  • Models
  • Tool Approvals
  • Plugins (for Serper web search)
  • MCP

Slash commands

Type these directly in the input box:

  • /connect - connect a provider (API key / base URL)
  • /models - pick a model
  • /approvals - approvals mode (auto / approve-for-me / normal)
  • /sessions - list sessions
  • /new - new session
  • /timeline - jump to a user message
  • /mcp - configure MCP connectors and settings
  • /plugins - configure plugins like Serper web search
  • /language - switch UI language
  • /theme - toggle light/dark theme

Troubleshooting

No API key / unauthorized

  • Use /connect (recommended), or set OPENAI_API_KEY in your environment.