dimcode 0.0.16-beta.2 → 0.0.16

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,29 +164,45 @@ 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
+### Connect a Provider
 
-Create a `.env` file in your working directory or set environment variables:
+Use one of these flows:
+
+1. Launch the CLI:
 
 ```bash
-# 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
+dim
+```
+
+2. Open provider setup:
+
+```text
+/connect
+```
 
-# Serper API for web search (optional)
-SERPER_API_KEY=your_serper_key_here
+3. Choose your provider and model, then start chatting.
 
-# Custom home directory (optional)
-DIMCODE_HOME=~/.dimcode
+You can also open settings any time with:
 
-# Debug mode (optional)
-DIMCODE_DEBUG=1
+```text
+/settings
 ```
 
-**Note**: For backward compatibility, `GOATCHAIN_` prefix is also supported (e.g., `GOATCHAIN_MODEL`, `GOATCHAIN_DEBUG`).
+or press `Ctrl+K`.
 
 ### First-time Setup
 
@@ -178,7 +212,145 @@ On first launch, Dimcode will guide you through:
 2. **Model Selection** - Choose your preferred AI model
 3. **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).
+### Codex OAuth
+
+If you want to use Codex OAuth, you can sign in from the CLI:
+
+```bash
+dim auth codex
+```
+
+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.
+
+### 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
+```
+
+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
+```
+
+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
+```
+
+If you use `DIMCODE_HOME`, replace `~/.dimcode` with that directory.
+
+You can also skip `/mcp` and edit that file directly. The file format is:
+
+```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"
+        }
+      }
+    ]
+  }
+}
+```
+
+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`.
+
+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.
 
 ## 🔧 Built-in Tools
 
@@ -211,7 +383,7 @@ Dimcode comes with powerful built-in tools:
 
 ### Skills
 
-Skills are specialized capabilities that can be activated to extend DimCode's functionality. Built-in skills include:
+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
@@ -239,6 +411,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

package/assets/gui/200.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>GoatChain GUI</title><script type="text/javascript">
+            (function() {
+              try {
+                const savedTheme = localStorage.getItem('goatchain-theme');
+                const prefersDark = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
+                const shouldUseDark = savedTheme === 'dark' || (!savedTheme && prefersDark);
+                if (shouldUseDark) {
+                  document.documentElement.classList.add('dark');
+                }
+              } catch (e) {}
+            })();
+          </script><link rel="stylesheet" href="/_nuxt/entry.CEtVlF9V.css" crossorigin><link rel="stylesheet" href="/_nuxt/vendor-markstream.D6yyxftE.css" crossorigin><link rel="stylesheet" href="/_nuxt/vendor-katex.ltkKqWhd.css" crossorigin><link rel="modulepreload" as="script" crossorigin href="/_nuxt/DTsXV384.js"><link rel="modulepreload" as="script" crossorigin href="/_nuxt/Cd_MtzEZ.js"><link rel="modulepreload" as="script" crossorigin href="/_nuxt/DLcXGJ1M.js"><link rel="modulepreload" as="script" crossorigin href="/_nuxt/ULB_ug-y.js"><script type="module" src="/_nuxt/DTsXV384.js" crossorigin></script><meta name="description" content="GoatChain GUI - shared event stream viewer and query console."><script id="unhead:payload" type="application/json">{"title":"GoatChain GUI"}</script></head><body><div id="__nuxt"></div><div id="teleports"></div><script>window.__NUXT__={};window.__NUXT__.config={public:{},app:{baseURL:"/",buildId:"23cb514b-b517-423e-9289-35684b02b352",buildAssetsDir:"/_nuxt/",cdnURL:""}}</script><script type="application/json" data-nuxt-data="nuxt-app" data-ssr="false" id="__NUXT_DATA__">[{"prerenderedAt":1,"serverRendered":2},1771915830058,false]</script></body></html>

package/assets/gui/404.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>GoatChain GUI</title><script type="text/javascript">
+            (function() {
+              try {
+                const savedTheme = localStorage.getItem('goatchain-theme');
+                const prefersDark = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
+                const shouldUseDark = savedTheme === 'dark' || (!savedTheme && prefersDark);
+                if (shouldUseDark) {
+                  document.documentElement.classList.add('dark');
+                }
+              } catch (e) {}
+            })();
+          </script><link rel="stylesheet" href="/_nuxt/entry.CEtVlF9V.css" crossorigin><link rel="stylesheet" href="/_nuxt/vendor-markstream.D6yyxftE.css" crossorigin><link rel="stylesheet" href="/_nuxt/vendor-katex.ltkKqWhd.css" crossorigin><link rel="modulepreload" as="script" crossorigin href="/_nuxt/DTsXV384.js"><link rel="modulepreload" as="script" crossorigin href="/_nuxt/Cd_MtzEZ.js"><link rel="modulepreload" as="script" crossorigin href="/_nuxt/DLcXGJ1M.js"><link rel="modulepreload" as="script" crossorigin href="/_nuxt/ULB_ug-y.js"><script type="module" src="/_nuxt/DTsXV384.js" crossorigin></script><meta name="description" content="GoatChain GUI - shared event stream viewer and query console."><script id="unhead:payload" type="application/json">{"title":"GoatChain GUI"}</script></head><body><div id="__nuxt"></div><div id="teleports"></div><script>window.__NUXT__={};window.__NUXT__.config={public:{},app:{baseURL:"/",buildId:"23cb514b-b517-423e-9289-35684b02b352",buildAssetsDir:"/_nuxt/",cdnURL:""}}</script><script type="application/json" data-nuxt-data="nuxt-app" data-ssr="false" id="__NUXT_DATA__">[{"prerenderedAt":1,"serverRendered":2},1771915830059,false]</script></body></html>

package/assets/gui/_nuxt/B4BeXTM8.js

@@ -0,0 +1 @@
+import{u as s,c as a,o as i,a as t,t as n,b as u,w as c,d as l,e as d}from"./Cd_MtzEZ.js";import{_ as f}from"./DlAUqK2U.js";const p={class:"antialiased bg-white dark:bg-[#020420] dark:text-white font-sans grid min-h-screen overflow-hidden place-content-center text-[#020420] tracking-wide"},m={class:"max-w-520px text-center"},h=["textContent"],b=["textContent"],x=["textContent"],g={class:"flex items-center justify-center w-full"},y={__name:"error-404",props:{appName:{type:String,default:"Nuxt"},status:{type:Number,default:404},statusText:{type:String,default:"Page not found"},description:{type:String,default:"Sorry, the page you are looking for could not be found."},backHome:{type:String,default:"Go back home"}},setup(e){const r=e;return s({title:`${r.status} - ${r.statusText} | ${r.appName}`,script:[{innerHTML:`!function(){const e=document.createElement("link").relList;if(!(e&&e.supports&&e.supports("modulepreload"))){for(const e of document.querySelectorAll('link[rel="modulepreload"]'))r(e);new MutationObserver(e=>{for(const o of e)if("childList"===o.type)for(const e of o.addedNodes)"LINK"===e.tagName&&"modulepreload"===e.rel&&r(e)}).observe(document,{childList:!0,subtree:!0})}function r(e){if(e.ep)return;e.ep=!0;const r=function(e){const r={};return e.integrity&&(r.integrity=e.integrity),e.referrerPolicy&&(r.referrerPolicy=e.referrerPolicy),"use-credentials"===e.crossOrigin?r.credentials="include":"anonymous"===e.crossOrigin?r.credentials="omit":r.credentials="same-origin",r}(e);fetch(e.href,r)}}();`}],style:[{innerHTML:'*,:after,:before{border-color:var(--un-default-border-color,#e5e7eb);border-style:solid;border-width:0;box-sizing:border-box}:after,:before{--un-content:""}html{line-height:1.5;-webkit-text-size-adjust:100%;font-family:ui-sans-serif,system-ui,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji;font-feature-settings:normal;font-variation-settings:normal;-moz-tab-size:4;tab-size:4;-webkit-tap-highlight-color:transparent}body{line-height:inherit;margin:0}h1,h2{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}h1,h2,p{margin:0}*,:after,:before{--un-rotate:0;--un-rotate-x:0;--un-rotate-y:0;--un-rotate-z:0;--un-scale-x:1;--un-scale-y:1;--un-scale-z:1;--un-skew-x:0;--un-skew-y:0;--un-translate-x:0;--un-translate-y:0;--un-translate-z:0;--un-pan-x: ;--un-pan-y: ;--un-pinch-zoom: ;--un-scroll-snap-strictness:proximity;--un-ordinal: ;--un-slashed-zero: ;--un-numeric-figure: ;--un-numeric-spacing: ;--un-numeric-fraction: ;--un-border-spacing-x:0;--un-border-spacing-y:0;--un-ring-offset-shadow:0 0 transparent;--un-ring-shadow:0 0 transparent;--un-shadow-inset: ;--un-shadow:0 0 transparent;--un-ring-inset: ;--un-ring-offset-width:0px;--un-ring-offset-color:#fff;--un-ring-width:0px;--un-ring-color:rgba(147,197,253,.5);--un-blur: ;--un-brightness: ;--un-contrast: ;--un-drop-shadow: ;--un-grayscale: ;--un-hue-rotate: ;--un-invert: ;--un-saturate: ;--un-sepia: ;--un-backdrop-blur: ;--un-backdrop-brightness: ;--un-backdrop-contrast: ;--un-backdrop-grayscale: ;--un-backdrop-hue-rotate: ;--un-backdrop-invert: ;--un-backdrop-opacity: ;--un-backdrop-saturate: ;--un-backdrop-sepia: }'}]}),(k,w)=>{const o=d;return i(),a("div",p,[t("div",m,[t("h1",{class:"font-semibold leading-none mb-4 sm:text-[110px] tabular-nums text-[80px]",textContent:n(e.status)},null,8,h),t("h2",{class:"font-semibold mb-2 sm:text-3xl text-2xl",textContent:n(e.statusText)},null,8,b),t("p",{class:"mb-4 px-2 text-[#64748B] text-md",textContent:n(e.description)},null,8,x),t("div",g,[u(o,{to:"/",class:"font-medium hover:text-[#00DC82] text-sm underline underline-offset-3"},{default:c(()=>[l(n(e.backHome),1)]),_:1})])])])}}},N=f(y,[["__scopeId","data-v-c8d5998f"]]);export{N as default};