dimcode 0.0.16-beta.2 → 0.0.16-beta.3

package/README.md

@@ -2,11 +2,15 @@
 
 # Dimcode CLI
 
-> A powerful AI agent CLI with a beautiful interactive terminal UI (TUI)
+> An AI coding agent CLI and terminal coding assistant with a beautiful interactive TUI
 
 [![npm version](https://badge.fury.io/js/dimcode.svg)](https://badge.fury.io/js/dimcode)
 
-Dimcode is a command-line interface for AI-powered coding assistance. It helps you move fast with:
+Dimcode is an AI coding CLI for terminal-first developers who want fast code generation, refactoring, repo search, code review, and agent-style workflows directly in the shell.
+
+If you are searching for a CLI coding tool similar to Claude Code, Codex, OpenCode, or Cursor's terminal workflow, Dimcode is built for the same terminal-native use case while adding a polished multi-session TUI, tool approvals, MCP support, and flexible provider setup.
+
+Dimcode helps you move fast with:
 
 - 🎨 **Beautiful TUI** - Modern terminal interface built with Vue 3
 
@@ -25,6 +29,18 @@ Dimcode is a command-line interface for AI-powered coding assistance. It helps y
 | Weekly downloads | [![npm downloads (week)](https://img.shields.io/npm/dw/dimcode)](https://www.npmjs.com/package/dimcode)  |
 | Total downloads  | [![npm downloads (total)](https://img.shields.io/npm/dt/dimcode)](https://www.npmjs.com/package/dimcode) |
 
+## Why Developers Search for Dimcode
+
+Dimcode is designed for developers looking for:
+
+- An **AI coding CLI** for daily programming tasks
+- A **terminal coding assistant** for large codebases
+- A **Claude Code alternative** with a richer TUI
+- A **Codex CLI alternative** for multi-session work
+- An **OpenCode alternative** with built-in tool approvals
+- A **Cursor alternative for terminal users** who prefer staying in the shell
+- A **CLI AI agent** for refactors, debugging, repo Q&A, and web research
+
 ## ⚡ Get Started in 30 Seconds
 
 1. Install the CLI
@@ -47,6 +63,8 @@ Create a React component for a todo list
 
 ## 📦 Installation
 
+Install Dimcode as your AI coding assistant CLI:
+
 ### Global Installation (Recommended)
 
 ```bash
@@ -146,6 +164,18 @@ Type slash commands directly in the input field:
 - `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
 
+## Dimcode vs Other AI Coding Tools
+
+If you are comparing Dimcode with Claude Code, Codex, OpenCode, or Cursor, the main difference is that Dimcode focuses on a terminal-first agent experience with:
+
+- **Interactive TUI workflows** instead of a minimal chat-only shell
+- **Multi-session conversation management** for parallel coding tasks
+- **Tool approvals and built-in tools** for safer repo operations
+- **Flexible provider and model configuration** for custom setups
+- **ACP / MCP connectivity** for editor and tool integrations
+
+That makes it a good fit for developers who want an AI code assistant in the terminal, but need more control and visibility than a basic CLI chat loop.
+
 ## ⚙️ Configuration
 
 ### Environment Variables
@@ -180,6 +210,24 @@ On first launch, Dimcode will guide you through:
 
 Settings are stored in `~/.dimcode/dimcode/` directory by default (can be customized via `DIMCODE_HOME` environment variable).
 
+## ACP Server
+
+DimCode can run as an ACP server for editors and tools such as Zed or OpenClaw `acpx`.
+
+Preferred commands:
+
+```bash
+dim acp
+```
+
+```bash
+node /absolute/path/to/GoatChain/scripts/acpx-agent.mjs
+```
+
+For GUI launchers, prefer absolute paths instead of relying on shell `PATH`.
+Do not configure `bun run acp-server` in `acpx` or editor settings; it only works when the cwd is the GoatChain repo root.
+If you use Codex OAuth, run `dim auth codex` once first. If you use a custom provider, make sure `~/.dimcode/config.json` already contains a valid provider setup.
+
 ## 🔧 Built-in Tools
 
 Dimcode comes with powerful built-in tools:
@@ -239,6 +287,13 @@ dim
 # Then type: "Search for the latest best practices in TypeScript 5.3"
 ```
 
+### Compare CLI Coding Agents
+
+```bash
+dim
+# Then type: "Compare Dimcode with Claude Code, Codex, OpenCode, and Cursor for terminal-first development"
+```
+
 ## 🔐 Security & Privacy
 
 - **Tool Approvals**: By default, sensitive operations (file writes, shell commands) require user approval