@kimicode/cli 1.0.37

package/README.md

@@ -0,0 +1,221 @@
+# @deepseekcode/cli
+
+[![npm version](https://img.shields.io/npm/v/@deepseekcode/cli.svg)](https://www.npmjs.com/package/@deepseekcode/cli)
+[![License: Proprietary](https://img.shields.io/badge/license-Proprietary-red.svg)](#license)
+[![Node version](https://img.shields.io/node/v/@deepseekcode/cli.svg)](https://nodejs.org)
+
+**DeepSeekCode CLI** — a TypeScript-first AI coding agent with an interactive terminal UI, a built-in web UI, and a local HTTP/WS runtime. It starts a full agent core in-process, opens an [Ink](https://github.com/vadimdemedes/ink) (React-for-terminal) interface in your terminal, and serves a companion web UI you can use for configuration and remote access.
+
+- **TUI** — interactive, keyboard-first coding agent in your terminal
+- **Local runtime** — spins up an in-process server (HTTP + WebSocket), no separate install needed
+- **Web UI** — configuration & model management at `http://localhost:8080`
+- **Non-interactive modes** — `exec`, `codeview`, `test-fix` for scripts & CI
+- **Multi-theme** — dark / light / nord / dracula / monokai / one-dark / tokyo-night
+
+Requires **Node.js >= 18**.
+
+---
+
+## Install
+
+```bash
+npm install -g @deepseekcode/cli
+```
+
+Or with your favorite package manager:
+
+```bash
+# pnpm
+pnpm add -g @deepseekcode/cli
+
+# yarn
+yarn global add @deepseekcode/cli
+
+# bun
+bun add -g @deepseekcode/cli
+```
+
+This installs two commands: **`dscode`** (short) and **`deepseekcode`** (full name).
+
+## Quick Start
+
+```bash
+dscode
+```
+
+That's it. The CLI starts the local agent runtime and opens the interactive terminal. On first run (no provider configured) it prints a link to the web UI where you can set up your LLM provider and model:
+
+```bash
+# model/provider setup page (also served by the CLI)
+# → http://localhost:8080/#models
+```
+
+If your terminal's stdin isn't a TTY (e.g. a script or CI pipeline), the CLI skips the TUI and runs **headless** — the web UI stays available at the printed URL.
+
+Connect to an **existing** backend instead of starting a local one:
+
+```bash
+dscode run --backend http://localhost:8080
+```
+
+Resume your last session (or a specific one):
+
+```bash
+dscode --resume          # last session
+dscode --resume <id>     # specific session
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `dscode` / `dscode start` | Start local runtime + interactive TUI (also serves Web UI + API) |
+| `dscode start --auto` | Start with auto-approval mode enabled |
+| `dscode run --backend URL` | Connect to an existing backend instead of starting one |
+| `dscode exec <command>` | Execute a command non-interactively (JSONL output) |
+| `dscode exec --file <path>` | Read the command from a file |
+| `dscode codeview` | AI code review — bugs + unwired features (JSON output) |
+| `dscode review` | Review current code changes (legacy) |
+| `dscode test-fix` | Run the auto-fix test loop |
+| `dscode --resume [id]` | Resume the last session, or a specific one |
+| `dscode version` | Print version |
+
+Run `dscode --help` (or `-h`) for the full list.
+
+### Non-interactive examples
+
+```bash
+# Execute a command, get JSONL results
+dscode exec "fix the failing test in src/utils"
+
+# Plain text output, command from file
+dscode exec --file ./task.txt --text
+
+# AI code review focused on security, write report to file
+dscode codeview --focus security --output review.json
+
+# Auto-fix test loop (max 5 retries, analyze only)
+dscode test-fix --packages packages/cli --retries 5 --dry-run
+```
+
+## Interactive Commands
+
+Inside the TUI, use `/help` for the full list (most commands have Chinese aliases). Highlights:
+
+| Command | Action |
+|---------|--------|
+| `/help` | Show all commands |
+| `/model [name]` | Open model picker or switch model directly |
+| `/theme [name]` | Show or change terminal theme |
+| `/plan` | Toggle plan mode (review before executing) |
+| `/auto` | Toggle auto-approval mode |
+| `/mode <mode>` | Cycle/set mode: act · auto-act · plan · auto-plan · goal · auto-goal |
+| `/goal` | Set goal-directed mode |
+| `/thinking` | Toggle think mode on/off |
+| `/context` | Show current conversation state |
+| `/sessions [id]` / `/resume [id]` | List history / switch session |
+| `/tasks` | Toggle sub-task output panel |
+| `/undo [list]` | Undo the most recent file change |
+| `/clear` | Start a new session (current session is saved, resumable via `/sessions`) |
+| `/mcp <action>` | Manage MCP servers |
+| `/skills` | Insert a skill |
+| `/trace <traceId>` | Query a trace by id |
+| `/stop` `/pause` `/continue` | Control AI generation |
+| `/exit` | Exit |
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-p, --port <port>` | HTTP port (default: first available from 8080) |
+| `--ws-port <port>` | WebSocket port (default: HTTP port + 1) |
+| `-w, --workspace <dir>` | Workspace directory (default: current directory) |
+| `-F, --force` | Kill an existing process on the target port before starting |
+| `-b, --backend <url>` | Backend URL for `run` mode |
+| `--ws <url>` | Override WebSocket URL |
+| `--provider <name>` | Provider to use (exec/review) |
+| `--model <name>` | Model to use (exec/review) |
+| `--theme <name\|path>` | Theme name or JSON theme file path |
+| `--prompt-version <ver>` | Prompt template version |
+| `--timeout <ms>` | Per-attempt LLM timeout (default: 300000 = 5 min) |
+| `--stall-threshold <ms>` | Stream stall detection threshold (default: 240000 = 4 min) |
+| `--no-update-check` | Disable the startup new-version notice |
+| `--no-auto-update` | Disable background auto-update (notice still shown) |
+
+## Configuration
+
+The CLI reads `~/.agent/config.yaml`:
+
+```yaml
+backend_url: http://localhost:8080
+ws_url: ws://localhost:8081/ws
+workspace_dir: /path/to/workspace
+```
+
+Provider / model settings are managed through the web UI at `http://localhost:8080/#models`.
+
+## Themes
+
+Set the theme at startup via the `DEEPSEEKCODE_THEME` env var (or `--theme`):
+
+| Theme | Env Value | Style |
+|-------|-----------|-------|
+| Dark (default) | `dark` | ANSI named colors, broad compat |
+| Light | `light` | Light terminal variant |
+| Nord | `nord` | Arctic blue-grey palette |
+| Dracula | `dracula` | Dark purple-vibrant |
+| Monokai | `monokai` | Classic code editor |
+| One Dark | `one-dark` | Atom's iconic dark |
+| Tokyo Night | `tokyo-night` | Deep navy + vibrant accents |
+
+```bash
+DEEPSEEKCODE_THEME=nord dscode
+DEEPSEEKCODE_THEME=/path/to/my-theme.json dscode
+
+# Partial overrides on the current theme (JSON)
+DEEPSEEKCODE_THEME_COLORS='{"primary":"#ff0000"}' dscode
+```
+
+Switch themes at runtime with `/theme [name]`.
+
+## Auto-Update
+
+On startup, `dscode` checks npm for the latest version asynchronously (non-blocking). When a newer version is found, the CLI **automatically reinstalls the global package** in the background (`npm install -g @deepseekcode/cli@latest`); the new version takes effect on the next launch.
+
+- Only affects **global npm installs** — source builds and `npx`/`bunx` caches are never touched.
+- Disable auto-install (keep the version notice): `DEEPSEEKCODE_NO_AUTO_UPDATE=1` or `--no-auto-update`
+- Disable the check entirely: `DEEPSEEKCODE_NO_UPDATE_CHECK=1` or `--no-update-check`
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `DEEPSEEKCODE_THEME` | Theme name or JSON theme file |
+| `DEEPSEEKCODE_THEME_COLORS` | JSON partial color overrides |
+| `DEEPSEEKCODE_HTTP_PORT` / `DEEPSEEKCODE_WS_PORT` | Default HTTP / WebSocket ports |
+| `DEEPSEEKCODE_QUIET=1` | Suppress non-fatal startup warnings |
+| `DEEPSEEKCODE_NO_AUTO_UPDATE=1` | Disable background auto-update |
+| `DEEPSEEKCODE_NO_UPDATE_CHECK=1` | Disable the version check |
+| `DEEPSEEKCODE_FORCE_UTF8=0` | Skip forcing the Windows console to UTF-8 |
+| `DSC_HEAP_LIMIT_MB` | Node heap limit hint for large sessions (default: 8192) |
+
+## Terminal Verdict Figures
+
+The `terminal_figure` tool and the Web UI's terminal-verdict button replay captured ANSI bytes through xterm.js and Playwright, then compose a PNG with Python Pillow.
+
+The published package includes the replay/composition scripts and declares its Node dependencies. The host still needs:
+
+- a Python interpreter with Pillow installed;
+- a Playwright Chromium browser (`npx playwright install chromium` or the equivalent for your package manager).
+
+If either prerequisite is unavailable, the feature returns an actionable setup error and does not silently write outside the workspace. Capture remains a separate CLI/TUI step because it depends on the specific interface under test.
+
+## License
+
+Proprietary — © 2026 DeepSeekCode. All rights reserved.
+
+This software is proprietary and closed source; it is **not** open source. Copying,
+modifying, distributing, sublicensing, or selling it requires the prior written
+permission of the copyright holder.
+
+See `LICENSE.md` for the full terms.

package/bin/dscode.exe

@@ -0,0 +1,12 @@
+#!/bin/sh
+echo "Error: dscode native binary not installed." >&2
+echo "" >&2
+echo "Either postinstall did not run (--ignore-scripts, some pnpm configs)" >&2
+echo "or the platform-native optional dependency was not downloaded" >&2
+echo "(--omit=optional)." >&2
+echo "" >&2
+echo "Run the postinstall manually (adjust path for local vs global install):" >&2
+echo "  node node_modules/@deepseekcode/cli/install.cjs" >&2
+echo "" >&2
+echo "Or reinstall without --ignore-scripts / --omit=optional." >&2
+exit 1

package/cli-wrapper.cjs

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+// Fallback launcher for the @deepseekcode/cli wrapper package.
+//
+// Normally the postinstall script (install.cjs) copies the native binary over
+// bin/dscode(.exe), so this file is never invoked. It exists for environments
+// where postinstall doesn't run (--ignore-scripts) — users can run
+// `node cli-wrapper.cjs` directly and pay the Node-process overhead as the
+// price. Marks the child with DEEPSEEKCODE_INSTALLED_VIA_NPM_WRAPPER so the
+// binary knows it was reached through the npm wrapper (update path decisions).
+
+const { spawnSync } = require('child_process')
+const { arch, constants } = require('os')
+const path = require('path')
+
+// Platform detection + PLATFORMS map is duplicated in install.cjs — keep in sync.
+const WRAPPER_NAME = require('./package.json').name
+// Same scope as the wrapper (@<scope>/cli-<platform>) — derived, not hard-coded,
+// so one source file serves every published scope. Keep in sync with install.cjs.
+const PACKAGE_PREFIX = WRAPPER_NAME
+const BINARY_NAME = 'dscode'
+
+
+const PLATFORMS = {
+  'darwin-arm64': { pkg: PACKAGE_PREFIX + '-darwin-arm64', bin: BINARY_NAME },
+  'darwin-x64': { pkg: PACKAGE_PREFIX + '-darwin-x64', bin: BINARY_NAME },
+  'linux-x64': { pkg: PACKAGE_PREFIX + '-linux-x64', bin: BINARY_NAME },
+  'linux-arm64': { pkg: PACKAGE_PREFIX + '-linux-arm64', bin: BINARY_NAME },
+  'linux-x64-musl': { pkg: PACKAGE_PREFIX + '-linux-x64-musl', bin: BINARY_NAME },
+  'linux-arm64-musl': { pkg: PACKAGE_PREFIX + '-linux-arm64-musl', bin: BINARY_NAME },
+  'win32-x64': { pkg: PACKAGE_PREFIX + '-win32-x64', bin: BINARY_NAME + '.exe' },
+  'win32-arm64': { pkg: PACKAGE_PREFIX + '-win32-arm64', bin: BINARY_NAME + '.exe' },
+}
+
+function detectMusl() {
+  if (process.platform !== 'linux') return false
+  const report =
+    typeof process.report?.getReport === 'function'
+      ? process.report.getReport()
+      : null
+  return report != null && report.header?.glibcVersionRuntime === undefined
+}
+
+function getPlatformKey() {
+  const platform = process.platform
+  let cpu = arch()
+  if (platform === 'linux') {
+    return 'linux-' + cpu + (detectMusl() ? '-musl' : '')
+  }
+  if (platform === 'darwin' && cpu === 'x64') {
+    const r = spawnSync('sysctl', ['-n', 'sysctl.proc_translated'], { encoding: 'utf8' })
+    if (r.stdout?.trim() === '1') cpu = 'arm64'
+  }
+  return platform + '-' + cpu
+}
+
+function getBinaryPath() {
+  const platformKey = getPlatformKey()
+  const info = PLATFORMS[platformKey]
+  if (!info) {
+    console.error(`[${WRAPPER_NAME}] Unsupported platform: ${process.platform} ${arch()}. Supported: ${Object.keys(PLATFORMS).join(', ')}`)
+    process.exit(1)
+  }
+  const optionalDeps = require('./package.json').optionalDependencies || {}
+  if (!optionalDeps[info.pkg]) {
+    console.error(`[${WRAPPER_NAME}] Native binaries for ${platformKey} are not available on this release channel.`)
+    console.error(`  Available: ${Object.keys(optionalDeps).map((p) => p.replace(PACKAGE_PREFIX + '-', '')).join(', ')}`)
+    process.exit(1)
+  }
+  try {
+    const pkgDir = path.dirname(require.resolve(info.pkg + '/package.json'))
+    return path.join(pkgDir, info.bin)
+  } catch {
+    console.error(`[${WRAPPER_NAME}] Could not find native binary package "${info.pkg}".`)
+    if (platformKey === 'darwin-arm64' && arch() === 'x64') {
+      console.error('  You are running x64 Node under Rosetta 2 on Apple Silicon. npm only')
+      console.error('  installed the darwin-x64 binary.')
+    } else {
+      console.error('  Try reinstalling with: npm install')
+    }
+    process.exit(1)
+  }
+}
+
+function main() {
+  const binaryPath = getBinaryPath()
+  const result = spawnSync(binaryPath, process.argv.slice(2), {
+    stdio: 'inherit',
+    env: { ...process.env, DEEPSEEKCODE_INSTALLED_VIA_NPM_WRAPPER: '1' },
+  })
+  if (result.error) {
+    console.error(`[${WRAPPER_NAME}] Failed to execute native binary at ` + binaryPath)
+    console.error('  ' + result.error.message)
+    process.exit(1)
+  }
+  if (result.signal) {
+    // Node.js ignores some signals (e.g. SIGPIPE → SIG_IGN), so re-raising is
+    // unreliable. Exit with the POSIX convention 128+signum instead.
+    const signum = constants.signals[result.signal] ?? 0
+    process.exit(128 + signum)
+  } else {
+    process.exit(result.status ?? 1)
+  }
+}
+
+main()

package/install.cjs

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+// Postinstall for the @deepseekcode/cli wrapper package.
+//
+// Mirrors the Claude Code 2.x distribution model: the npm package is a thin
+// installer. This script detects the platform, finds the matching native binary
+// from optionalDependencies (@deepseekcode/cli-<platform>), and copies it over
+// the bin/dscode.exe placeholder. After this runs, `dscode` execs the native
+// binary directly — no Node process stays resident.
+//
+// If the native package isn't present (--omit=optional), prints instructions and
+// leaves the placeholder stub in place. cli-wrapper.cjs (same directory) can be
+// invoked manually as a fallback.
+//
+// On Windows the stub (a non-PE .exe) surfaces as a native "not a valid Win32
+// application" error, so its message is best-effort; install.cjs failure output
+// above is the primary guidance when postinstall does run.
+//
+// Platform detection + PLATFORMS map is duplicated in cli-wrapper.cjs — keep in sync.
+
+const { spawnSync } = require('child_process')
+const {
+  copyFileSync,
+  linkSync,
+  unlinkSync,
+  chmodSync,
+  readFileSync,
+  writeFileSync,
+  statSync,
+} = require('fs')
+const { arch } = require('os')
+const path = require('path')
+
+const WRAPPER_NAME = require('./package.json').name
+// Platform packages live in the SAME npm scope as the wrapper
+// (@<scope>/cli-<platform>). Derived rather than hard-coded so one source file
+// serves every scope the release is published to (see scripts/multi-publish.mjs).
+const PACKAGE_PREFIX = WRAPPER_NAME
+const BINARY_NAME = 'dscode'
+
+
+const PLATFORMS = {
+  'darwin-arm64': { pkg: PACKAGE_PREFIX + '-darwin-arm64', bin: BINARY_NAME },
+  'darwin-x64': { pkg: PACKAGE_PREFIX + '-darwin-x64', bin: BINARY_NAME },
+  'linux-x64': { pkg: PACKAGE_PREFIX + '-linux-x64', bin: BINARY_NAME },
+  'linux-arm64': { pkg: PACKAGE_PREFIX + '-linux-arm64', bin: BINARY_NAME },
+  'linux-x64-musl': { pkg: PACKAGE_PREFIX + '-linux-x64-musl', bin: BINARY_NAME },
+  'linux-arm64-musl': { pkg: PACKAGE_PREFIX + '-linux-arm64-musl', bin: BINARY_NAME },
+  'win32-x64': { pkg: PACKAGE_PREFIX + '-win32-x64', bin: BINARY_NAME + '.exe' },
+  'win32-arm64': { pkg: PACKAGE_PREFIX + '-win32-arm64', bin: BINARY_NAME + '.exe' },
+}
+
+function detectMusl() {
+  if (process.platform !== 'linux') return false
+  // process.report is available in Node ≥12; glibcVersionRuntime is absent on musl.
+  // Faster than spawning `ldd` and avoids the ENOENT→musl false positive when ldd
+  // isn't on PATH (minimal containers).
+  const report =
+    typeof process.report?.getReport === 'function'
+      ? process.report.getReport()
+      : null
+  return report != null && report.header?.glibcVersionRuntime === undefined
+}
+
+function getPlatformKey() {
+  const platform = process.platform
+  let cpu = arch()
+  if (platform === 'linux') {
+    return 'linux-' + cpu + (detectMusl() ? '-musl' : '')
+  }
+  // Rosetta 2: an x64 Node on Apple Silicon reports arch()==='x64'. Prefer the
+  // native arm64 binary — the x64 build needs AVX, which Rosetta doesn't emulate.
+  if (platform === 'darwin' && cpu === 'x64') {
+    const r = spawnSync('sysctl', ['-n', 'sysctl.proc_translated'], { encoding: 'utf8' })
+    if (r.stdout?.trim() === '1') cpu = 'arm64'
+  }
+  return platform + '-' + cpu
+}
+
+function placeBinary(src, dest) {
+  // Try hardlink first (instant, zero extra disk for a ~110MB binary; src and
+  // dest are both under node_modules/ so same-filesystem is the common case).
+  // We attempt the link BEFORE touching dest — if src is missing (partial
+  // extraction) the first linkSync throws ENOENT and the fallback stub stays.
+  try {
+    linkSync(src, dest)
+  } catch (err) {
+    if (err.code === 'EEXIST') {
+      // Read the stub before unlinking so we can restore it if both link and
+      // copy fail (ENOSPC, NFS error mid-copy). Only read if dest is
+      // stub-sized — on re-install dest is the ~110MB binary.
+      const stub = statSync(dest).size < 4096 ? readFileSync(dest) : null
+      unlinkSync(dest)
+      try {
+        linkSync(src, dest)
+      } catch {
+        try {
+          copyFileSync(src, dest)
+        } catch (copyErr) {
+          if (stub) {
+            try {
+              writeFileSync(dest, stub, { mode: 0o755 })
+            } catch {
+              // Do nothing
+            }
+          }
+          throw copyErr
+        }
+      }
+    } else if (err.code === 'EXDEV' || err.code === 'EPERM') {
+      // Cross-device or no-link-perms — copyFileSync overwrites existing dest.
+      copyFileSync(src, dest)
+    } else {
+      throw err
+    }
+  }
+  if (process.platform !== 'win32') {
+    chmodSync(dest, 0o755)
+  }
+}
+
+function main() {
+  const platformKey = getPlatformKey()
+  const info = PLATFORMS[platformKey]
+
+  if (!info) {
+    console.error(
+      `[${WRAPPER_NAME} postinstall] Unsupported platform: ${process.platform} ${arch()}`,
+    )
+    console.error(`  Supported: ${Object.keys(PLATFORMS).join(', ')}`)
+    return
+  }
+
+  const optionalDeps = require('./package.json').optionalDependencies || {}
+  if (!optionalDeps[info.pkg]) {
+    console.error(
+      `[${WRAPPER_NAME} postinstall] Native binaries for ${platformKey} are not available on this release channel.`,
+    )
+    console.error(`  Available: ${Object.keys(optionalDeps).map((p) => p.replace(PACKAGE_PREFIX + '-', '')).join(', ')}`)
+    return
+  }
+
+  let src
+  try {
+    const pkgDir = path.dirname(require.resolve(info.pkg + '/package.json'))
+    src = path.join(pkgDir, info.bin)
+  } catch {
+    console.error(`[${WRAPPER_NAME} postinstall] Native package "${info.pkg}" not found.`)
+    if (platformKey === 'darwin-arm64' && arch() === 'x64') {
+      console.error('  You are running x64 Node under Rosetta 2 on Apple Silicon. npm only')
+      console.error('  installed the darwin-x64 binary. Install arm64 Node and reinstall:')
+      console.error('    arch -arm64 zsh -c "nvm install --lts && npm i -g ' + WRAPPER_NAME + '"')
+      return
+    }
+    console.error('  This happens with --omit=optional or when the download failed.')
+    console.error('  The `dscode` command will print instructions when invoked.')
+    console.error('  Fallback: node ' + path.join(__dirname, 'cli-wrapper.cjs'))
+    return
+  }
+
+  // Always write to bin/dscode.exe — the package.json bin field points here
+  // (npm generates its shim/symlink from the .exe extension at install time).
+  // On Unix npm links `bin/dscode` → `bin/dscode.exe` and ignores the
+  // extension, so overwriting the .exe path replaces the running target on
+  // every platform. Same pattern as Claude Code / Bun npm packages.
+  const dest = path.join(__dirname, 'bin', 'dscode.exe')
+
+  try {
+    placeBinary(src, dest)
+    console.log(`[${WRAPPER_NAME} postinstall] Native binary placed → ${dest}`)
+  } catch (err) {
+    console.error(`[${WRAPPER_NAME} postinstall] Failed to place binary: ${err.message}`)
+    console.error('  Fallback: node ' + path.join(__dirname, 'cli-wrapper.cjs'))
+    process.exitCode = 1
+  }
+}
+
+main()

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@kimicode/cli",
+  "version": "1.0.37",
+  "description": "DeepSeekCode TypeScript CLI",
+  "type": "module",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "bin": {
+    "dscode": "bin/dscode.exe",
+    "kimicode": "bin/dscode.exe"
+  },
+  "scripts": {
+    "postinstall": "node install.cjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "playwright": "1.62.1",
+    "xterm": "5.3.0"
+  },
+  "optionalDependencies": {
+    "@kimicode/cli-darwin-arm64": "1.0.37",
+    "@kimicode/cli-darwin-x64": "1.0.37",
+    "@kimicode/cli-linux-x64": "1.0.37",
+    "@kimicode/cli-linux-arm64": "1.0.37",
+    "@kimicode/cli-linux-x64-musl": "1.0.37",
+    "@kimicode/cli-linux-arm64-musl": "1.0.37",
+    "@kimicode/cli-win32-x64": "1.0.37",
+    "@kimicode/cli-win32-arm64": "1.0.37"
+  },
+  "files": [
+    "bin/",
+    "install.cjs",
+    "cli-wrapper.cjs",
+    "web/dist/",
+    "scripts/figure/",
+    "README.md"
+  ]
+}