dimcode

Dimcode CLI

A powerful AI agent CLI built on GoatChain with an interactive terminal UI (TUI)

Dimcode is a command-line interface for AI-powered coding assistance, featuring:

• 🎨 Beautiful TUI - Modern terminal interface built with Vue 3
• 💬 Multi-session Management - Manage multiple AI conversations
• 🔧 Built-in Tools - File operations, web search, code analysis
• ⚡ Streaming Responses - Real-time AI response streaming
• 🎯 Tool Approvals - Fine-grained control over tool execution
• 🌈 Themes - Customizable color schemes

📦 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

🚀 Quick Start

After installation, simply run:

dim

This will launch the interactive terminal UI.

🎮 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
/approvals	Manage tool approvals
/sessions	List all sessions
/new	Create a new session
/redo	Redo last interaction (Chat view only)

Keyboard Shortcuts

Shortcut	Action
Ctrl+P	Open command palette
Ctrl+C	Exit the application
Enter	Send message
Shift+Enter	New line in input

⚙️ 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
MODEL_ID=gpt-4o  # Default model

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

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 ~/.goatchain/goatchain/ directory by default (can be customized via GOATCHAIN_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
• AstGrepSearch - AST-based code search
• AstGrepReplace - AST-based code refactoring

Web & Research

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

Task Management

• TodoWrite - Create and manage TODO lists
• Task - Execute complex multi-step tasks
• Skill - Store and reuse common workflows

System

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

📚 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 ~/.goatchain/goatchain/ (customizable via GOATCHAIN_HOME)