dimcode

Dimcode CLI

A powerful AI agent CLI with a beautiful interactive terminal UI (TUI)

Dimcode is a command-line interface for AI-powered coding assistance. It helps you move fast with:

• 🎨 Beautiful TUI - Modern terminal interface built with Vue 3

• 💬 Multi-session Management - Organize multiple AI conversations
• 🔧 Built-in Tools - File ops, web search, code analysis, and more
• ⚡ Streaming Responses - See AI outputs in real time
• 🎯 Tool Approvals - Granular control over tool execution
• 🌈 Themes - Flexible, customizable color schemes

📈 Download Stats

Metric	Live Badge
Weekly downloads
Total downloads

⚡ Get Started in 30 Seconds

• Install the CLI

npm install -g dimcode

• Run it

dim

• Ask for help

Create a React component for a todo list

📦 Installation

Global Installation (Recommended)

npm install -g dimcode

Or using other package managers:

# Using pnpm
pnpm add -g dimcode

# Using yarn
yarn global add dimcode

# Using bun
bun add -g dimcode

Using npx (No Installation)

Run directly without installation:

npx dimcode

🎮 Usage

Command Palette

Press Ctrl+P to open the command palette, which provides quick access to:

• Sessions - View and switch between conversations
• New Session - Start a fresh conversation
• Settings - Configure API keys and model settings
• Tool Approvals - Manage tool execution permissions
• Theme - Customize the UI appearance (in Chat view)

Slash Commands

Type slash commands directly in the input field:

Command	Description
/settings	Open settings dialog (custom providers)
/config	Alternative for /settings
/approvals	Manage tool approvals (auto/all)
/approval	Alternative for /approvals
/connect	Connect a provider
/models	Select a model
/sessions	List all sessions
/new	Create a new session
/redo	Redo last interaction
/rename <title>	Rename current session
/timeline	Jump to a user message
/tl	Alternative for /timeline
/review	Review code changes
/debug	Open debug dialog (node mode only)
/compact	Compact session context
/init	Initialize/improve AGENTS.md
/exit	Exit the application
/longrunning	Toggle long-running mode
/tool-settings	Configure tool-specific settings
/toolsettings	Alternative for /tool-settings
/mcp	Open MCP settings
/mcphub	Alternative for /mcp
/mcp-settings	Alternative for /mcp
/codexlogin	Login with Codex OAuth
/codex-login	Alternative for /codexlogin
/language	Switch UI language
/lang	Alternative for /language
/locale	Alternative for /language
/theme	Toggle light/dark theme

Keyboard Shortcuts

Shortcut	Action
Ctrl+P	Open command palette
F1	Open help dialog
Ctrl+O	Expand/collapse all tool calls & thinking
Ctrl+K	Open settings (custom providers)
Ctrl+C	Clear input (if non-empty); otherwise exit
Ctrl+W	Clear input (alternative)
Enter	Send message
Shift+Enter	New line in input
Ctrl+J	New line in input (alternative)
Tab	Switch mode (Agent/Plan/Debug)
Esc	Cancel/close dialog or interrupt response

Input Tips

• Drag to select text, then release to auto-copy (when enabled)
• In the input area, use Shift+Option for rectangular selection
• Triple-click in the input area to select all
• Tab moves focus to the next input field; Shift+Tab moves to the previous
• The CLI is mouse-friendly for selection, scrolling, and clicking buttons/controls

⚙️ Configuration

Environment Variables

Create a .env file in your working directory or set environment variables:

# OpenAI Configuration
OPENAI_API_KEY=your_api_key_here
OPENAI_BASE_URL=https://api.openai.com/v1  # Optional
DIMCODE_MODEL=deepseek-v3.1  # Default model

# Serper API for web search (optional)
SERPER_API_KEY=your_serper_key_here

# Custom home directory (optional)
DIMCODE_HOME=~/.dimcode

# Debug mode (optional)
DIMCODE_DEBUG=1

Note: For backward compatibility, GOATCHAIN_ prefix is also supported (e.g., GOATCHAIN_MODEL, GOATCHAIN_DEBUG).

First-time Setup

On first launch, Dimcode will guide you through:

• API Key Setup - Enter your OpenAI API key
• Model Selection - Choose your preferred AI model
• Tool Approvals - Configure which tools can run automatically

Settings are stored in ~/.dimcode/dimcode/ directory by default (can be customized via DIMCODE_HOME environment variable).

🔧 Built-in Tools

Dimcode comes with powerful built-in tools:

File Operations

• Read - Read file contents
• Write - Create or overwrite files
• Edit - Make precise edits to existing files

Code Analysis

• Grep - Search content using patterns
• Glob - Find files by pattern

Web & Research

• WebSearch - Search the web using Serper API
• WebFetch - Fetch web page content

Task Management

• TodoWrite - Create and manage TODO lists

System

• Bash - Execute shell commands (requires approval)
• AskUser - Request input from user

Skills

Skills are specialized capabilities that can be activated to extend DimCode's functionality. Built-in skills include:

• skill-installer - Install Codex skills from curated list or GitHub repos
• skill-creator - Guide for creating effective skills

📚 Examples

Basic Coding Assistant

dim
# Then type: "Create a React component for a todo list"

Multi-file Refactoring

dim
# Then type: "Rename all instances of 'oldName' to 'newName' across the project"

Web Research

dim
# Then type: "Search for the latest best practices in TypeScript 5.3"

🔐 Security & Privacy

• Tool Approvals: By default, sensitive operations (file writes, shell commands) require user approval
• Local Storage: All session data is stored locally in ~/.dimcode/dimcode/ (customizable via DIMCODE_HOME)