subconscious-cli 4.0.3 → 4.0.5

package/README.md

@@ -21,8 +21,8 @@ never block the requested command. Set `SUBC_DISABLE_UPDATE_CHECK=1` to suppress
 the check in offline automation.
 
 Login creates both the saved credential and a ready-to-use `default` profile,
-so Claude Code, Codex, and OpenCode can launch immediately. Persistent editor
-and Pi integrations are installed per agent:
+so Claude Code, Codex, OpenCode, and DeepSeek Harness can launch immediately.
+Persistent editor and Pi integrations are installed per agent:
 
 ```bash
 subc cursor install
@@ -57,6 +57,7 @@ subc claude --continue
 subc codex exec "write a test"
 subc opencode
 subc pi
+subc dsh
 ```
 
 ## Supported agents
@@ -71,8 +72,9 @@ The packaged integrations live in `cli/bin/runbook`.
 | `subc cursor install` | Install/update Cursor conversation and compaction hooks |
 | `subc copilot install` | Install/update the VS Code custom endpoint and Copilot hooks |
 | `subc pi` | Refresh the Pi provider from the live catalog, then launch |
+| `subc dsh` | Launch the DeepSeek Harness Web UI with a temporary provider populated from the live catalog |
 
-If Claude Code, Codex, or OpenCode is missing, an interactive terminal offers
+If Claude Code, Codex, OpenCode, or DeepSeek Harness is missing, an interactive terminal offers
 to install it before launching. Pi refreshes its Subconscious provider on every
 `subc pi` launch while preserving all other providers in `models.json`; its
 executable must already be installed.
@@ -112,6 +114,13 @@ Manage Language Models UI. The install scripts print the relevant next steps.
 The runbook scripts require Bash. Cursor, Copilot, Pi, and Codex hook merge
 also require `jq`; Cursor and Copilot also require `curl`.
 
+`subc dsh` defaults to the DeepSeek Harness Web UI. It injects an ephemeral
+Cordis overlay containing the active gateway URL, selected model, token limits,
+client header, and every model returned by `/v1/models`; the API key remains in
+the process environment and is never written into the overlay. The temporary
+file is removed when Harness exits, and existing `$DSH_HOME` settings are not
+rewritten. Run a one-shot task with `subc dsh headless "PROMPT"`.
+
 ## Runbook profiles
 
 `subc login` automatically creates:
@@ -121,8 +130,8 @@ also require `jq`; Cursor and Copilot also require `curl`.
 ```
 
 The file is mode `600` and contains the shared gateway URL, API key, model,
-optional per-agent key overrides, and all Claude/Codex/OpenCode/Pi/Copilot
-context and output settings used by the packaged runbook scripts.
+optional per-agent key overrides, and all Claude/Codex/OpenCode/Pi/Copilot/
+DeepSeek Harness context and output settings used by the packaged runbook scripts.
 
 ```bash
 subc config                         # list every profile and its file path
@@ -186,8 +195,9 @@ export SUBCONSCIOUS_MODEL=subconscious/glm-5.2
 ```
 
 Every launch and install fetches the same live catalog without caching. Codex,
-OpenCode, Pi, Copilot, and Cursor receive the complete model list. The selected
-profile model is listed first only while the gateway still advertises it.
+OpenCode, Pi, Copilot, Cursor, and DeepSeek Harness receive the complete model
+list. The selected profile model is listed first only while the gateway still
+advertises it.
 OpenCode rebuilds its isolated runtime provider on every `subc opencode` launch,
 so models left in older OpenCode configuration files do not leak into the list.
 If a saved profile default has been removed, launches use the first live model;

package/bin/agents.js

@@ -232,6 +232,18 @@ const AGENT_HELP = {
       ['ARGS...', 'Pass arguments directly to Pi'],
     ],
   },
+  'deepseek-harness': {
+    usage: 'subc [-p NAME] dsh [web|headless] [--model MODEL] [Harness arguments...]',
+    behavior:
+      'Launches DeepSeek Harness with a temporary Subconscious provider containing every live gateway model. Web mode is the default.',
+    options: [
+      ['help', 'Show this help'],
+      ['web', 'Launch the DeepSeek Harness Web UI (default)'],
+      ['headless PROMPT', 'Run one headless task and exit'],
+      ['--model MODEL', 'Set the initial model for new Harness sessions'],
+      ['ARGS...', 'Pass remaining arguments to the selected Harness mode'],
+    ],
+  },
 };
 
 export function isAgentHelpRequest(argv = []) {

package/bin/branding.js

@@ -1,4 +1,4 @@
-import { colorEnabled } from './colors.js';
+import { BRAND_ORANGE, colorEnabled } from './colors.js';
 
 // Pre-rendered from assets/imgs/logo.png as portable, 7-bit ASCII art.
 const LOGO = [
@@ -20,7 +20,6 @@ const LOGO = [
   '      ######        #####',
 ].join('\n');
 
-const ORANGE = '\x1b[38;2;255;92;40m';
 const BOLD = '\x1b[1m';
 const RESET = '\x1b[0m';
 
@@ -34,6 +33,6 @@ export function renderBanner(options = {}) {
   // still get the same logo without ANSI styling.
   if (!isTTY || term === 'dumb') return `  ${title}`;
 
-  const logo = color ? `${ORANGE}${LOGO}${RESET}` : LOGO;
+  const logo = color ? `${BRAND_ORANGE}${LOGO}${RESET}` : LOGO;
   return `${logo}\n\n  ${title}`;
 }

package/bin/colors.js

@@ -10,6 +10,11 @@ export const colorEnabled =
   (forceColor || process.stdout.isTTY === true);
 
 const ansi = (code) => (colorEnabled ? `\x1b[${code}m` : '');
+const rgb = (red, green, blue) =>
+  colorEnabled ? `\x1b[38;2;${red};${green};${blue}m` : '';
+const bgRgb = (red, green, blue) =>
+  colorEnabled ? `\x1b[48;2;${red};${green};${blue}m` : '';
+export const BRAND_ORANGE = '\x1b[38;2;255;92;40m';
 
 export const c = {
   reset: ansi(0),
@@ -20,6 +25,10 @@ export const c = {
   red: ansi(31),
   yellow: ansi(33),
   magenta: ansi(35),
+  black: ansi(30),
+  orange: colorEnabled ? BRAND_ORANGE : '',
+  orangeSoft: rgb(255, 145, 105),
+  bgOrange: bgRgb(255, 92, 40),
   underline: ansi(4),
   inverse: ansi(7),
 };

package/bin/profiles.js

@@ -44,6 +44,7 @@ export const RUNBOOK_DEFAULTS = {
   CURSOR_API_KEY: '',
   COPILOT_API_KEY: '',
   PI_API_KEY: '',
+  DEEPSEEK_HARNESS_API_KEY: '',
   CLAUDE_CODE_AUTO_COMPACT_WINDOW: '1000000',
   CLAUDE_CODE_MAX_CONTEXT_TOKENS: '3000000',
   MAX_CONCURRENT_SUBAGENTS: '4',
@@ -57,6 +58,8 @@ export const RUNBOOK_DEFAULTS = {
   OPENCODE_OUTPUT_LIMIT: '65536',
   PI_CONTEXT_WINDOW: '5000000',
   PI_MAX_TOKENS: '65536',
+  DEEPSEEK_HARNESS_CONTEXT_WINDOW: '5000000',
+  DEEPSEEK_HARNESS_MAX_TOKENS: '65536',
   COPILOT_MAX_INPUT_TOKENS: '5000000',
   COPILOT_MAX_OUTPUT_TOKENS: '65536',
   VSCODE_APP: '',
@@ -238,6 +241,26 @@ const SETTINGS = {
     type: 'integer',
     min: 1,
   },
+  DEEPSEEK_HARNESS_API_KEY: {
+    key: 'DEEPSEEK_HARNESS_API_KEY',
+    label: 'DeepSeek Harness API key',
+    description: 'DeepSeek Harness credential override; blank uses API_KEY.',
+    type: 'secret',
+  },
+  DEEPSEEK_HARNESS_CONTEXT_WINDOW: {
+    key: 'DEEPSEEK_HARNESS_CONTEXT_WINDOW',
+    label: 'Context window',
+    description: 'Context capacity advertised to DeepSeek Harness.',
+    type: 'integer',
+    min: 1,
+  },
+  DEEPSEEK_HARNESS_MAX_TOKENS: {
+    key: 'DEEPSEEK_HARNESS_MAX_TOKENS',
+    label: 'Maximum output tokens',
+    description: 'Output capacity advertised to DeepSeek Harness.',
+    type: 'integer',
+    min: 1,
+  },
 };
 
 const AGENT_SETTING_KEYS = {
@@ -267,6 +290,11 @@ const AGENT_SETTING_KEYS = {
     'VSCODE_APP',
   ],
   pi: ['PI_API_KEY', 'PI_CONTEXT_WINDOW', 'PI_MAX_TOKENS'],
+  'deepseek-harness': [
+    'DEEPSEEK_HARNESS_API_KEY',
+    'DEEPSEEK_HARNESS_CONTEXT_WINDOW',
+    'DEEPSEEK_HARNESS_MAX_TOKENS',
+  ],
 };
 
 const GROUP_KEYS = [
@@ -313,6 +341,7 @@ OPENCODE_API_KEY={OPENCODE_API_KEY}
 CURSOR_API_KEY={CURSOR_API_KEY}
 COPILOT_API_KEY={COPILOT_API_KEY}
 PI_API_KEY={PI_API_KEY}
+DEEPSEEK_HARNESS_API_KEY={DEEPSEEK_HARNESS_API_KEY}
 
 # Claude Code
 # Leave CLAUDE_GATEWAY_URL blank to use GATEWAY_URL above.
@@ -337,6 +366,10 @@ OPENCODE_OUTPUT_LIMIT={OPENCODE_OUTPUT_LIMIT}
 PI_CONTEXT_WINDOW={PI_CONTEXT_WINDOW}
 PI_MAX_TOKENS={PI_MAX_TOKENS}
 
+# DeepSeek Harness
+DEEPSEEK_HARNESS_CONTEXT_WINDOW={DEEPSEEK_HARNESS_CONTEXT_WINDOW}
+DEEPSEEK_HARNESS_MAX_TOKENS={DEEPSEEK_HARNESS_MAX_TOKENS}
+
 # GitHub Copilot
 COPILOT_MAX_INPUT_TOKENS={COPILOT_MAX_INPUT_TOKENS}
 COPILOT_MAX_OUTPUT_TOKENS={COPILOT_MAX_OUTPUT_TOKENS}

package/bin/registry.generated.json

@@ -291,6 +291,36 @@
           "uninstall"
         ]
       }
+    },
+    {
+      "id": "deepseek-harness",
+      "command": "dsh",
+      "name": "DeepSeek Harness",
+      "aliases": [
+        "deepseek-harness",
+        "deepseek"
+      ],
+      "description": "Launch DeepSeek Harness with an ephemeral Subconscious provider populated from the live model catalog.",
+      "framework": "DeepSeek Harness",
+      "language": "shell",
+      "category": "coding-agent",
+      "tags": [
+        "local",
+        "web",
+        "agents"
+      ],
+      "protocol": "openai",
+      "homepage": "https://www.deepseek.com/harness/en/",
+      "bin": "dsh",
+      "install": {
+        "darwin": "npm i -g @deepseek-ai/dsh",
+        "linux": "npm i -g @deepseek-ai/dsh",
+        "win32": "npm i -g @deepseek-ai/dsh"
+      },
+      "runbook": {
+        "mode": "launch",
+        "script": "deepseek-harness/run.sh"
+      }
     }
   ]
 }

package/bin/runbook/README.md

@@ -1,7 +1,8 @@
 # Coding-agent integrations
 
 These scripts are part of `subc`. They launch or surgically install Claude Code,
-Codex, OpenCode, Cursor, Copilot, and Pi against the Subconscious gateway.
+Codex, OpenCode, DeepSeek Harness, Cursor, Copilot, and Pi against the
+Subconscious gateway.
 
 `subc` reads `~/.subconscious/profiles/<name>.env` and injects those values into
 the scripts, so users do not need a sibling `.env` file. When a script is run
@@ -15,6 +16,7 @@ Included integrations:
 - `cursor/install.sh`, `hook.sh`, and `hooks.json`
 - `copilot/install.sh`, `hook.sh`, and `hooks.json`
 - `pi/install.sh`, `run.sh`, and `subconscious-compaction.ts`
+- `deepseek-harness/run.sh`
 
 Each CLI-enabled entry in `agents/registry.json` points here with a `runbook`
 block. Persistent writes are merge/unmerge only: they never replace a user's

package/bin/runbook/deepseek-harness/run.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+# Launch DeepSeek Harness with a temporary Cordis overlay that adds the live
+# Subconscious catalog. The user's DSH settings and profiles are not rewritten.
+
+set -euo pipefail
+
+GATEWAY_URL="${GATEWAY_URL:-}"
+API_KEY="${DEEPSEEK_HARNESS_API_KEY:-${API_KEY:-}}"
+MODEL="${MODEL:-subconscious/glm-5.2}"
+CONTEXT_WINDOW="${DEEPSEEK_HARNESS_CONTEXT_WINDOW:-5000000}"
+MAX_TOKENS="${DEEPSEEK_HARNESS_MAX_TOKENS:-65536}"
+
+DEFAULT_SUBCONSCIOUS_MODELS="subconscious/glm-5.2
+subconscious/tim-qwen3.6-27b
+subconscious/deepseek-v4-flash-marathon"
+
+if [[ -z "$GATEWAY_URL" || -z "$API_KEY" ]]; then
+  echo "error: GATEWAY_URL and API_KEY are required to launch DeepSeek Harness" >&2
+  exit 1
+fi
+if [[ ! "$CONTEXT_WINDOW" =~ ^[1-9][0-9]*$ ]]; then
+  echo "error: DEEPSEEK_HARNESS_CONTEXT_WINDOW must be a positive integer" >&2
+  exit 1
+fi
+if [[ ! "$MAX_TOKENS" =~ ^[1-9][0-9]*$ ]]; then
+  echo "error: DEEPSEEK_HARNESS_MAX_TOKENS must be a positive integer" >&2
+  exit 1
+fi
+
+SUPPORTED_MODELS=()
+add_supported_model() {
+  local model_id="$1" existing
+  [[ -n "$model_id" ]] || return 0
+  if [[ ! "$model_id" =~ ^[-A-Za-z0-9._:/+]+$ ]]; then
+    echo "error: invalid model id: $model_id" >&2
+    exit 1
+  fi
+  if [[ "${#SUPPORTED_MODELS[@]}" -gt 0 ]]; then
+    for existing in "${SUPPORTED_MODELS[@]}"; do
+      [[ "$existing" == "$model_id" ]] && return 0
+    done
+  fi
+  SUPPORTED_MODELS+=("$model_id")
+}
+
+add_supported_model "$MODEL"
+while IFS= read -r model_id; do
+  add_supported_model "$model_id"
+done <<< "${SUBCONSCIOUS_MODELS:-$DEFAULT_SUBCONSCIOUS_MODELS}"
+
+OVERLAY_DIR="$(mktemp -d "${TMPDIR:-/tmp}/subc-dsh.XXXXXX")"
+OVERLAY_FILE="${OVERLAY_DIR}/subconscious.cordis.yml"
+cleanup() {
+  rm -f "$OVERLAY_FILE"
+  rmdir "$OVERLAY_DIR" 2>/dev/null || true
+}
+trap cleanup EXIT HUP INT TERM
+
+{
+  printf '%s\n' \
+    '# Generated temporarily by subc. Contains no API key.' \
+    '- id: llm-pi-ai' \
+    '  config:' \
+    '    providers:' \
+    '      subconscious:' \
+    '        apiKeyEnv: SUBCONSCIOUS_API_KEY' \
+    '        displayName: Subconscious Gateway' \
+    '        api: openai-completions' \
+    '        baseURL: !!js process.env.SUBCONSCIOUS_DSH_BASE_URL' \
+    '        headers:' \
+    '          x-subconscious-client: deepseek-harness' \
+    '        compat:' \
+    '          supportsDeveloperRole: false' \
+    '          maxTokensField: max_tokens' \
+    "        defaultContextWindow: ${CONTEXT_WINDOW}" \
+    "        defaultMaxTokens: ${MAX_TOKENS}" \
+    '        models:'
+  for model_id in "${SUPPORTED_MODELS[@]}"; do
+    printf "          - id: '%s'\n" "$model_id"
+    printf "            name: '%s'\n" "$model_id"
+    printf "            contextWindow: %s\n" "$CONTEXT_WINDOW"
+    printf "            maxTokens: %s\n" "$MAX_TOKENS"
+  done
+  printf '%s\n' \
+    '- id: agent-default-model' \
+    '  config:' \
+    '    provider: subconscious' \
+    "    model: '${MODEL}'"
+} >"$OVERLAY_FILE"
+chmod 600 "$OVERLAY_FILE"
+
+export SUBCONSCIOUS_API_KEY="$API_KEY"
+export SUBCONSCIOUS_DSH_BASE_URL="${GATEWAY_URL%/}/v1"
+
+mode="web"
+if [[ "${1:-}" == "web" || "${1:-}" == "headless" ]]; then
+  mode="$1"
+  shift
+fi
+
+set +e
+if [[ "$mode" == "headless" ]]; then
+  dsh --profile headless --patch "$OVERLAY_FILE" "$@"
+else
+  dsh web --patch "$OVERLAY_FILE" "$@"
+fi
+status=$?
+set -e
+exit "$status"

package/bin/update-check.js

@@ -1,11 +1,18 @@
 import fs from 'node:fs/promises';
 import { spawn } from 'node:child_process';
 import readline from 'node:readline';
-import { c } from './colors.js';
+import { c, colorEnabled } from './colors.js';
 
 export const PACKAGE_NAME = 'subconscious-cli';
 export const UPDATE_CHECK_TIMEOUT_MS = 1500;
 const UPDATE_ACTIONS = ['Update now', 'Skip for now'];
+const UPDATE_LOGO = [
+  '  ●     ●',
+  '   ╲   ╱ ',
+  '●─── ╳ ───●',
+  '   ╱   ╲ ',
+  '  ●     ●',
+];
 
 function parseVersion(version) {
   const match = String(version)
@@ -85,18 +92,32 @@ export async function fetchLatestVersion(options = {}) {
 }
 
 export function renderUpdateNotice(installedVersion, latestVersion) {
-  const title = 'Subconscious CLI update available';
-  const versions = `${installedVersion} -> ${latestVersion}`;
-  const width = Math.max(title.length, versions.length);
-  const border = `+${'-'.repeat(width + 2)}+`;
-  const row = (text, style = '') =>
-    `${c.yellow}|${c.reset} ${style}${text.padEnd(width)}${c.reset} ${c.yellow}|${c.reset}`;
+  const logoWidth = Math.max(...UPDATE_LOGO.map((line) => line.length));
+  const textWidth = 24;
+  const gap = '   ';
+  const innerWidth = logoWidth + gap.length + textWidth + 2;
+  const border = `${c.orange}╭${'─'.repeat(innerWidth)}╮${c.reset}`;
+  const bottom = `${c.orange}╰${'─'.repeat(innerWidth)}╯${c.reset}`;
+  const text = [
+    { raw: 'Subconscious CLI', value: `${c.orange}${c.bold}Subconscious CLI${c.reset}` },
+    { raw: 'Update available', value: `${c.bold}Update available${c.reset}` },
+    { raw: '', value: '' },
+    {
+      raw: `${installedVersion}  →  ${latestVersion}`,
+      value: `${c.dim}${installedVersion}${c.reset}  ${c.orange}→${c.reset}  ${c.orange}${c.bold}${latestVersion}${c.reset}`,
+    },
+    { raw: '', value: '' },
+  ];
+  const row = (logo, copy) => {
+    const logoPadding = ' '.repeat(logoWidth - logo.length);
+    const textPadding = ' '.repeat(textWidth - copy.raw.length);
+    return `${c.orange}│${c.reset} ${c.orange}${logo}${logoPadding}${c.reset}${gap}${copy.value}${textPadding} ${c.orange}│${c.reset}`;
+  };
 
   return [
-    `  ${c.yellow}${border}${c.reset}`,
-    `  ${row(title, c.bold)}`,
-    `  ${row(versions, c.cyan)}`,
-    `  ${c.yellow}${border}${c.reset}`,
+    `  ${border}`,
+    ...UPDATE_LOGO.map((logo, index) => `  ${row(logo, text[index])}`),
+    `  ${bottom}`,
   ].join('\n');
 }
 
@@ -110,11 +131,14 @@ export function renderUpdateOptions(selectedIndex = 0, versions = {}) {
 
   return UPDATE_ACTIONS.map((label, index) => {
     const active = index === selectedIndex;
-    const pointer = active ? `${c.cyan}>${c.reset}` : ' ';
+    const pointer = active ? `${c.orange}›${c.reset}` : ' ';
+    const activeStyle = colorEnabled
+      ? `${c.bgOrange}${c.black}`
+      : c.inverse;
     const option = active
-      ? `${c.inverse}${c.bold} ${label} ${c.reset}`
+      ? `${activeStyle}${c.bold} ${label} ${c.reset}`
       : ` ${label} `;
-    const descriptionStyle = active ? c.cyan : c.dim;
+    const descriptionStyle = active ? c.orangeSoft : c.dim;
     return `  ${pointer} ${option}\n      ${descriptionStyle}${descriptions[index]}${c.reset}`;
   }).join('\n');
 }
@@ -132,7 +156,7 @@ export async function selectUpdateAction(options = {}) {
   const output = options.output || process.stderr;
   const initiallyRaw = input.isRaw === true;
   let selectedIndex = options.selectedIndex ?? 0;
-  const instructions = `  ${c.dim}Use ↑/↓ to select • Enter to confirm${c.reset}`;
+  const instructions = `  ${c.dim}Use ${c.orange}↑/↓${c.reset}${c.dim} to select  •  ${c.orange}Enter${c.reset}${c.dim} to confirm${c.reset}`;
   const render = () =>
     `${renderUpdateOptions(selectedIndex, {
       installedVersion: options.installedVersion,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "subconscious-cli",
-  "version": "4.0.3",
-  "description": "CLI for Subconscious — run Claude Code, Codex, OpenCode, Cursor, Copilot, and Pi",
+  "version": "4.0.5",
+  "description": "CLI for Subconscious — run Claude Code, Codex, OpenCode, DeepSeek Harness, Cursor, Copilot, and Pi",
   "bin": {
     "subc": "bin/cli.js"
   },
@@ -34,6 +34,7 @@
     "cursor",
     "copilot",
     "pi",
+    "deepseek-harness",
     "launcher"
   ],
   "author": "Subconscious Systems",