dimcode 0.0.20 → 0.0.21

package/README.md

@@ -1,473 +1,132 @@
-<img src="https://storage-static.fazhiplus.com/zmchat-avatar/0752d736887697a3284138d013052e53+MjI1ZWM1YTAtNmE4Zi00ZWRkLWI0NjktZjNlNzM4N2U0M2M3LjBkZDI2ODc1LWYxMGYtNDBhNC05NWQ1LWJiZGY2ZmEwM2M0OXgxNzY5NzQ4MDM4MTcyNDEwNzYw" alt="Brand Logo" height="100">
+<img src="https://storage-static.fazhiplus.com/zmchat-avatar/0752d736887697a3284138d013052e53+MjI1ZWM1YTAtNmE4Zi00ZWRkLWI0NjktZjNlNzM4N2U0M2M3LjBkZDI2ODc1LWYxMGYtNDBhNC05NWQ1LWJiZGY2ZmEwM2M0OXgxNzY5NzQ4MDM4MTcyNDEwNzYw" alt="Dimcode" height="100">
 
-# Dimcode CLI
-
-> An AI coding agent CLI and terminal coding assistant with a beautiful interactive TUI
+# Dimcode
 
 [![npm version](https://badge.fury.io/js/dimcode.svg)](https://badge.fury.io/js/dimcode)
+[![npm downloads (week)](https://img.shields.io/npm/dw/dimcode)](https://www.npmjs.com/package/dimcode)
+[![npm downloads (total)](https://img.shields.io/npm/dt/dimcode)](https://www.npmjs.com/package/dimcode)
 
-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
-
-<img src="https://storage-static.fazhiplus.com/zmchat-avatar/7b06958a80a23e038609f65f6c39d1f4+MjI1ZWM1YTAtNmE4Zi00ZWRkLWI0NjktZjNlNzM4N2U0M2M3LjEyOTVhYTU1LWI4YTgtNDA3YS1hNDliLTExMTgxOTU0YTM1NngxNzcwMTkzMzEwOTY2NjM5NjY0" alt="UI" height="300">
-
-- 💬 **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 | [![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
-
-```bash
-npm install -g dimcode
-```
-
-2. Run it
-
-```bash
-dim
-```
-
-3. Ask for help
+AI coding agent for the terminal. Multi-session TUI, 24+ LLM providers, built-in tools, MCP/ACP support.
 
-```text
-Create a React component for a todo list
-```
+<img src="https://storage-static.fazhiplus.com/zmchat-avatar/7b06958a80a23e038609f65f6c39d1f4+MjI1ZWM1YTAtNmE4Zi00ZWRkLWI0NjktZjNlNzM4N2U0M2M3LjEyOTVhYTU1LWI4YTgtNDA3YS1hNDliLTExMTgxOTU0YTM1NngxNzcwMTkzMzEwOTY2NjM5NjY0" alt="Dimcode TUI" height="300">
 
-## 📦 Installation
+## Quick Start
 
-Install Dimcode as your AI coding assistant CLI:
-
-### Global Installation (Recommended)
+## 安装
 
 ```bash
-npm install -g dimcode
-```
-
-Or using other package managers:
-
-```bash
-# Using pnpm
-pnpm add -g dimcode
-
-# Using yarn
-yarn global add dimcode
-
-# Using bun
-bun add -g dimcode
+npm install -g @dimcode/cli
 ```
 
-### Using npx (No Installation)
+## 快速开始
 
-Run directly without installation:
-
-```bash
-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
-
-## 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
-
-### Connect a Provider
-
-Use one of these flows:
-
-1. Launch the CLI:
+### 启动交互式会话
 
 ```bash
 dim
 ```
 
-2. Open provider setup:
-
-```text
-/connect
-```
-
-3. Choose your provider and model, then start chatting.
-
-You can also open settings any time with:
-
-```text
-/settings
-```
-
-or press `Ctrl+K`.
-
-### First-time Setup
-
-On first launch, Dimcode will guide you through:
-
-1. **API Key Setup** - Enter your OpenAI API key
-2. **Model Selection** - Choose your preferred AI model
-3. **Tool Approvals** - Configure which tools can run automatically
-
-### Codex OAuth
+进入交互模式后，你可以直接输入问题或任务，DimCode 会帮你完成。
 
-If you want to use Codex OAuth, you can sign in from the CLI:
+### 执行单次命令
 
 ```bash
-dim auth codex
+dim "帮我创建一个 React 组件"
 ```
 
-Inside the app, `/codexlogin` opens the same login flow.
+适合快速完成单个任务，执行完后自动退出。
 
-### Common CLI Setup Tasks
+## 交互命令
 
-- Use `/connect` to add or switch a provider
-- Use `/settings` to manage custom provider settings
-- Use `/models` to change the active model
-- Use `/approvals` to control tool execution permissions
-- Use `/tool-settings` to configure tool-specific settings such as WebSearch
-- Use `/mcp` to manage MCP integrations
+在交互模式下，你可以使用以下命令：
 
-Settings and local session data are stored in `~/.dimcode/dimcode/` by default.
+| 命令                | 说明               |
+| ------------------- | ------------------ |
+| `/help`             | 显示帮助信息       |
+| `/model`            | 查看或切换当前模型 |
+| `/history`          | 显示对话历史       |
+| `/clear`            | 清空当前对话       |
+| `/exit` 或 `Ctrl+C` | 退出程序           |
 
-### Active Session Runtime
+## 使用示例
 
-Dimcode also publishes a small runtime record that external tools can read for live context handoff (for example voice input tools, desktop automations, or editor helpers).
+### 代码相关
 
-By default the files live under:
-
-```text
-~/.dimcode/dimcode/runtime/
 ```
-
-The main files are:
-
-- `active-session.json` - the single live runtime record for the current Dimcode context
-
-The runtime record includes fields such as:
-
-- `sessionId`
-- `cwd`
-- `title`
-- `mode`
-- `providerId`
-- `providerName`
-- `modelId`
-- `focused`
-- `visibility`
-- `updatedAt`
-
-The file is updated in-place as focus changes:
-
-- `focused` - Dimcode is the active terminal and the record contains the current chat session
-- `blurred` / `suspended` - Dimcode keeps the last session context, but it is not the active terminal
-- `inactive` - no chat session should be treated as active (for example on the home page)
-
-Current behavior:
-
-- Home screen clears the active session record so external tools do not pick up stale chat context
-- Chat screen publishes the current session and workspace
-- Terminal focus reporting is used when the terminal emulator supports xterm focus events
-- Suspend / resume (`Ctrl+Z` / `fg`) also updates visibility
-
-Dimcode also mirrors the core active context into process env for child-process integrations:
-
-- `DIMCODE_ACTIVE_SESSION_ID`
-- `DIMCODE_ACTIVE_SESSION_FOLDER`
-- `GOATCHAIN_ACTIVE_SESSION_ID`
-- `GOATCHAIN_ACTIVE_SESSION_FOLDER`
-
-These env vars are best for Dimcode-spawned tools and hooks. For cross-app integrations, prefer reading the runtime JSON files.
-
-### Skills Directory
-
-Dimcode automatically discovers skills from both global and project-local directories:
-
-- Global: `~/.agents/skills/`
-- Project-local: `<your-project>/.agents/skills/`
-- Compatibility paths also supported: `~/.claude/skills/` and `<your-project>/.claude/skills/`
-
-Each skill should live in its own folder with a `SKILL.md` file:
-
-```text
-~/.agents/skills/my-skill/SKILL.md
-<your-project>/.agents/skills/my-skill/SKILL.md
+> 帮我写一个 Python 函数，计算斐波那契数列
+> 把这个函数改成递归实现
+> 给这个函数加上类型注解
+> 写个单元测试
 ```
 
-If the same skill name exists in multiple places, project-local skills override global skills, and `.agents/skills` takes priority over `.claude/skills`.
-
-### Web Search Key
+### 文件操作
 
-To enable web search in the CLI, open:
-
-```text
-/tool-settings
 ```
-
-Then paste your WebSearch / Serper API key into the `WebSearch API Key` field and save.
-
-By default, Dimcode stores tool settings in:
-
-```text
-~/.dimcode/tools.json
+> 读取 src/utils.js 文件
+> 在 main.py 第 10 行后面添加日志
+> 搜索项目中所有使用 axios 的地方
 ```
 
-If you prefer environment variables for advanced setups, Dimcode also checks:
+### 命令执行
 
-- `DIMCODE_WEBSEARCH_KEY`
-- `SERPER_API_KEY`
-
-### MCP Configuration
-
-To configure MCP servers from the CLI, open:
-
-```text
-/mcp
 ```
-
-Paste MCP JSON into the editor, then use the built-in format / test actions before saving. Example:
-
-```json
-{
-  "mcpServers": {
-    "context7": {
-      "url": "https://mcp.context7.com/mcp",
-      "headers": {
-        "CONTEXT7_API_KEY": "YOUR_API_KEY"
-      }
-    }
-  }
-}
-```
-
-For Context7, this is the recommended hosted HTTP setup. If your MCP client supports MCP OAuth, Context7's official OAuth endpoint is:
-
-```text
-https://mcp.context7.com/mcp/oauth
-```
-
-In Dimcode, use the standard remote HTTP endpoint plus auth headers unless native MCP OAuth support is added for remote servers.
-
-CLI MCP settings are stored locally in:
-
-```text
-~/.dimcode/tools.json
+> 运行 npm test
+> 查看当前目录下的文件
+> 检查 git 状态
 ```
 
-If you use `DIMCODE_HOME`, replace `~/.dimcode` with that directory.
+## 配置
 
-You can also skip `/mcp` and edit that file directly. The file format is:
+配置文件位于 `~/.dimcode/config.json`：
 
 ```json
 {
-  "version": 1,
-  "updatedAt": 1735689600000,
-  "settings": {
-    "mcpServers": [
-      {
-        "id": "mcp_context7",
-        "name": "context7",
-        "transport": "http",
-        "url": "https://mcp.context7.com/mcp",
-        "headers": {
-          "CONTEXT7_API_KEY": "YOUR_API_KEY"
-        }
-      }
-    ]
-  }
+  "model": "gpt-4",
+  "apiKey": "your-api-key",
+  "theme": "dark"
 }
 ```
 
-Use `/mcp` when you want the friendlier editor and connection test UI. Edit `~/.dimcode/tools.json` directly when you want to script, sync, or manage MCP config as a file.
-
-## ACP Server
+也可以通过环境变量配置：
 
-Dimcode can run as an ACP server for editors and tools such as Zed or OpenClaw `acpx`.
+| 变量               | 说明         |
+| ------------------ | ------------ |
+| `DIMCODE_MODEL`    | 默认模型     |
+| `DIMCODE_API_KEY`  | API 密钥     |
+| `DIMCODE_BASE_URL` | API 基础 URL |
 
-Preferred commands:
+## 选项
 
 ```bash
-dim acp
-```
-
-```bash
-node /absolute/path/to/repo/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 repository 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.
+dim [选项] [命令]
 
-## 🔧 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
-
-```bash
-dim
-# Then type: "Create a React component for a todo list"
+选项:
+  -m, --model <model>     指定使用的模型
+  -c, --config <path>     指定配置文件路径
+  -v, --version           显示版本号
+  -h, --help              显示帮助信息
 ```
 
-### Multi-file Refactoring
-
-```bash
-dim
-# Then type: "Rename all instances of 'oldName' to 'newName' across the project"
-```
+## 特性
 
-### Web Research
+- **交互式对话**：支持多轮对话，保留上下文
+- **代码编辑**：读取、修改、创建文件
+- **命令执行**：运行 shell 命令
+- **流式输出**：实时显示响应
+- **历史记录**：自动保存对话历史
 
-```bash
-dim
-# Then type: "Search for the latest best practices in TypeScript 5.3"
-```
+## 快捷键
 
-### Compare CLI Coding Agents
+| 快捷键   | 功能                |
+| -------- | ------------------- |
+| `Ctrl+C` | 取消当前操作 / 退出 |
+| `Tab`    | 自动补全            |
+| `↑/↓`    | 浏览历史输入        |
 
-```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
-- **Local Storage**: All session data is stored locally in `~/.dimcode/dimcode/` (customizable via `DIMCODE_HOME`)
+- 在交互模式下输入 `/help`
+- 查看文档：https://docs.dimcode.dev
+- 提交 Issue：https://github.com/dimcode/cli/issues

package/cli.mjs

@@ -1,8 +1,71 @@
 #!/usr/bin/env node
+
+import { spawn, spawnSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import path from 'node:path'
+import process from 'node:process'
+import { fileURLToPath } from 'node:url'
+
+const cliPath = fileURLToPath(import.meta.url)
+const cliDir = path.dirname(cliPath)
+const sourceEntry = path.join(cliDir, 'src', 'cli.ts')
+const bundledEntry = path.join(cliDir, 'dist', 'cli.mjs')
+const sourceEntryUrl = new URL('./src/cli.ts', import.meta.url).href
+const bundledEntryUrl = new URL('./dist/cli.mjs', import.meta.url).href
+
+function resolveBunCommand() {
+  return process.env.BUN_BIN?.trim() || 'bun'
+}
+
+function canRelayToBunSource() {
+  if (typeof globalThis.Bun !== 'undefined')
+    return false
+  if (!existsSync(sourceEntry))
+    return false
+
+  const probe = spawnSync(resolveBunCommand(), ['--version'], { stdio: 'ignore' })
+  return probe.status === 0
+}
+
+async function relayToBunSource() {
+  const child = spawn(resolveBunCommand(), [cliPath, ...process.argv.slice(2)], {
+    stdio: 'inherit',
+    env: process.env,
+  })
+
+  const forwardSignal = (signal) => {
+    if (!child.killed)
+      child.kill(signal)
+  }
+
+  for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP'])
+    process.on(signal, () => forwardSignal(signal))
+
+  child.on('error', (error) => {
+    console.error(error)
+    process.exit(1)
+  })
+
+  await new Promise((resolve) => {
+    child.on('exit', (code) => {
+      process.exit(code ?? 1)
+    })
+    child.on('close', () => resolve())
+  })
+}
+
 if (typeof globalThis.Bun !== 'undefined') {
-  const { main } = await import('./src/cli.ts')
-  await main()
+  if (existsSync(bundledEntry))
+    await import(bundledEntryUrl)
+  else {
+    const { main } = await import(sourceEntryUrl)
+    await main()
+  }
+}
+else if (canRelayToBunSource()) {
+  // In source checkouts, prefer Bun so `node .../cli.mjs` uses the current TS sources.
+  await relayToBunSource()
 }
 else {
-  await import('./dist/cli.mjs')
+  await import(bundledEntryUrl)
 }