subconscious-cli 4.0.14 → 4.0.15

package/README.md

@@ -7,6 +7,7 @@ Log in to Subconscious, then run coding agents against the Subconscious gateway.
 ```bash
 npm install -g subconscious-cli
 subc login
+subc sc
 subc claude
 ```
 
@@ -21,7 +22,7 @@ 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, OpenCode, and DeepSeek Harness can launch immediately.
+so Subconscious Code, Claude Code, Codex, OpenCode, and DeepSeek Harness can launch immediately.
 Persistent editor and Pi integrations are installed per agent:
 
 ```bash
@@ -52,6 +53,7 @@ profile; they do not authenticate, install, configure, or launch anything:
 
 ```bash
 subc claude help
+subc sc help
 subc codex help
 subc cursor help
 subc config help
@@ -66,6 +68,7 @@ gateway environment applied for that process. Arguments pass through as usual:
 
 ```bash
 subc claude --continue
+subc sc -- -p "fix the tests"
 subc codex exec "write a test"
 subc opencode
 subc pi
@@ -78,6 +81,7 @@ The packaged integrations live in `cli/bin/runbook`.
 
 | Command | Behavior |
 | --- | --- |
+| `subc sc` | Launch Subconscious Code with the active gateway, key, model, and DLR transport |
 | `subc claude` | Launch Claude Code with the runbook environment, context limits, subagent limits, and OTEL usage reporting |
 | `subc codex` | Launch Codex with the runbook provider, temporary model catalog, and surgically merged compaction hooks |
 | `subc opencode` | Launch OpenCode with the runbook provider, client header, and context/output limits |
@@ -86,11 +90,16 @@ The packaged integrations live in `cli/bin/runbook`.
 | `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, OpenCode, or DeepSeek Harness is missing, an interactive terminal offers
+If Subconscious Code, 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.
 
+`subc sc install` downloads and checksum-verifies the latest static Linux release
+from `subconscious-systems/subconscious-code`. The upstream release currently
+publishes x86_64 and ARM64 Linux assets. On macOS, the installer uses Cargo to
+build the tagged release until Darwin assets are published.
+
 `subc codex` disables Codex apps and plugin tools for that launch by default so
 requests remain below the gateway's 128-tool limit. Core coding tools remain
 available. Use `subc codex --external-tools` to opt back in when targeting a
@@ -145,7 +154,7 @@ rewritten. Run a one-shot task with `subc dsh headless "PROMPT"`.
 ```
 
 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/
+optional per-agent key overrides, and all Subconscious Code/Claude/Codex/OpenCode/Pi/Copilot/
 DeepSeek Harness context and output settings used by the packaged runbook scripts.
 
 ```bash

package/bin/agents.js

@@ -164,6 +164,17 @@ export function parseAgentAction(agent, argv = []) {
 }
 
 const AGENT_HELP = {
+  'subconscious-code': {
+    usage: 'subc [-p NAME] sc [help|install] [Subconscious Code arguments...]',
+    behavior:
+      'Launches the native Subconscious coding agent with the selected profile gateway, credential, and model.',
+    options: [
+      ['help', 'Show this help'],
+      ['install', 'Install the latest Linux release, or build from source on macOS'],
+      ['--model MODEL', 'Override the profile model for this launch'],
+      ['ARGS...', 'Pass arguments directly to Subconscious Code'],
+    ],
+  },
   'claude-code': {
     usage: 'subc [-p NAME] claude [help|status|uninstall] [Claude arguments...]',
     behavior:
@@ -309,9 +320,10 @@ export function printAgentHelp(agent, profile) {
   );
   const actions = agentSetupActions(agent);
   if (actions.includes('install')) {
-    console.log(
-      `  Install the persistent integration with ${c.cyan}subc ${command} install${c.reset}.`,
-    );
+    const installDescription = agent.runbook?.binaryInstallScript
+      ? 'Install the agent binary with'
+      : 'Install the persistent integration with';
+    console.log(`  ${installDescription} ${c.cyan}subc ${command} install${c.reset}.`);
   }
   if (actions.includes('uninstall')) {
     console.log(
@@ -397,6 +409,7 @@ function candidateBinDirs() {
     if (home) dirs.push(path.join(home, '.local', 'bin'));
   } else {
     dirs.push(path.join(home, '.local', 'bin'));
+    dirs.push(path.join(home, '.cargo', 'bin'));
     dirs.push('/opt/homebrew/bin');
     dirs.push('/usr/local/bin');
   }
@@ -481,10 +494,15 @@ function waitForEnter(prompt) {
   });
 }
 
-/** Run the agent's install command (may contain `&&`, so shell:true). */
-function runInstaller(install) {
+/** Run the agent's packaged binary installer, or its shell install command. */
+function runInstaller(agent, install = agent.install, usePackagedScript = true) {
   return new Promise((resolve) => {
-    const child = spawn(install, { shell: true, stdio: 'inherit' });
+    const installScript = usePackagedScript && agent.runbook?.binaryInstallScript;
+    const child = installScript
+      ? spawn('bash', [runbookScriptPath(agent, installScript), 'install'], {
+          stdio: 'inherit',
+        })
+      : spawn(install, { shell: true, stdio: 'inherit' });
     child.on('error', () => resolve(false));
     child.on('exit', (code) => resolve(code === 0));
   });
@@ -544,14 +562,14 @@ async function ensureInstalled(agent) {
   }
 
   console.error(`\n  ${c.dim}Running ${c.reset}${c.cyan}${agent.install}${c.reset}\n`);
-  let installed = await runInstaller(agent.install);
+  let installed = await runInstaller(agent);
 
   // Primary failed and a fallback exists — try it once.
   if (!installed && agent.installFallback) {
     console.error(
       `\n  ${c.dim}That didn't work. Trying the fallback: ${c.reset}${c.cyan}${agent.installFallback}${c.reset}\n`,
     );
-    installed = await runInstaller(agent.installFallback);
+    installed = await runInstaller(agent, agent.installFallback, false);
   }
 
   if (!installed) {
@@ -874,7 +892,7 @@ export function selectLaunchModel(requestedModel, modelSource, catalog) {
 }
 
 async function runRunbookSetup(agent, argv, profile, relativeScript = agent.runbook.script) {
-  if (isSetupWithoutAuth(argv)) {
+  if (isSetupWithoutAuth(argv) || agent.runbook?.setupNeedsAuth === false) {
     return spawnRunbook(agent, argv, {
       ...(profile?.values || {}),
       ...process.env,

package/bin/profiles.js

@@ -38,6 +38,7 @@ export const RUNBOOK_DEFAULTS = {
   GATEWAY_URL: registry.defaults.baseUrl,
   API_KEY: '',
   MODEL: registry.defaults.model,
+  SC_API_KEY: '',
   CLAUDE_CODE_SUBAGENT_MODEL: '',
   CLAUDE_GATEWAY_URL: '',
   CLAUDE_CODE_API_KEY: '',
@@ -89,6 +90,12 @@ const SETTINGS = {
     type: 'choice',
     choices: SUPPORTED_MODELS,
   },
+  SC_API_KEY: {
+    key: 'SC_API_KEY',
+    label: 'Subconscious Code API key',
+    description: 'Subconscious Code credential override; blank uses API_KEY.',
+    type: 'secret',
+  },
   CLAUDE_CODE_SUBAGENT_MODEL: {
     key: 'CLAUDE_CODE_SUBAGENT_MODEL',
     label: 'Subagent model',
@@ -274,6 +281,7 @@ const SETTINGS = {
 };
 
 const AGENT_SETTING_KEYS = {
+  'subconscious-code': ['SC_API_KEY'],
   'claude-code': [
     'CLAUDE_GATEWAY_URL',
     'CLAUDE_CODE_API_KEY',
@@ -346,6 +354,7 @@ ${modelComments}
 MODEL={MODEL}
 
 # Optional per-agent keys. Leave blank to use API_KEY above.
+SC_API_KEY={SC_API_KEY}
 CLAUDE_CODE_API_KEY={CLAUDE_CODE_API_KEY}
 CODEX_API_KEY={CODEX_API_KEY}
 OPENCODE_API_KEY={OPENCODE_API_KEY}

package/bin/registry.generated.json

@@ -13,6 +13,49 @@
     "platformUrl": "https://subconscious.dev/platform"
   },
   "agents": [
+    {
+      "id": "subconscious-code",
+      "command": "sc",
+      "name": "Subconscious Code",
+      "aliases": [
+        "subconscious-code"
+      ],
+      "description": "Launch the native Subconscious coding agent with the active profile, gateway, and model.",
+      "framework": "Subconscious Code",
+      "language": "rust",
+      "category": "coding-agent",
+      "tags": [
+        "local",
+        "cli",
+        "agents"
+      ],
+      "protocol": "openai",
+      "homepage": "https://github.com/subconscious-systems/subconscious-code",
+      "bin": "sc",
+      "install": {
+        "darwin": "cargo install --locked --git https://github.com/subconscious-systems/subconscious-code --bin sc rc-cli",
+        "linux": "subc sc install",
+        "fallback": "cargo install --locked --git https://github.com/subconscious-systems/subconscious-code --bin sc rc-cli"
+      },
+      "runbook": {
+        "mode": "launch",
+        "script": "subconscious-code/run.sh",
+        "setupScript": "subconscious-code/install.sh",
+        "binaryInstallScript": "subconscious-code/install.sh",
+        "setupActions": [
+          "install"
+        ],
+        "setupNeedsAuth": false
+      },
+      "launch": "sc",
+      "env": {
+        "SC_BASE_URL": "{baseUrlV1}",
+        "SC_DLR_URL": "{baseUrl}",
+        "SC_DLR_ENABLED": "true",
+        "SC_API_KEY": "{apiKey}",
+        "SC_MODEL": "{model}"
+      }
+    },
     {
       "id": "claude-code",
       "command": "claude",

package/bin/runbook/README.md

@@ -1,7 +1,7 @@
 # Coding-agent integrations
 
 These scripts are part of `subc`. They launch or surgically install Claude Code,
-Codex, OpenCode, DeepSeek Harness, Cursor, Copilot, and Pi against the
+Subconscious Code, Codex, OpenCode, DeepSeek Harness, Cursor, Copilot, and Pi against the
 Subconscious gateway.
 
 `subc` reads `~/.subconscious/profiles/<name>.env` and injects those values into
@@ -10,6 +10,7 @@ directly, `SUBC_ENV_FILE` (or `cli/bin/runbook/.env`) can supply the same keys.
 
 Included integrations:
 
+- `subconscious-code/install.sh` and `run.sh`
 - `claude-code/install.sh` and `run.sh`
 - `codex/install.sh`, `run.sh`, `hook.sh`, `hooks.json`, and `hooks-lib.sh`
 - `opencode/install.sh`, `run.sh`, and `subconscious-compaction.ts`

package/bin/runbook/subconscious-code/install.sh

@@ -0,0 +1,147 @@
+#!/usr/bin/env bash
+# Install Subconscious Code. Tagged releases currently contain static Linux
+# binaries; macOS builds from the tagged source until Darwin assets are added.
+
+set -euo pipefail
+
+REPOSITORY="subconscious-systems/subconscious-code"
+REPOSITORY_URL="https://github.com/${REPOSITORY}"
+INSTALL_DIR="${SC_INSTALL_DIR:-${HOME}/.local/bin}"
+
+usage() {
+  cat <<'EOF'
+Usage: subc sc install
+
+Install the latest Subconscious Code release. Linux downloads and verifies the
+published static binary. macOS builds the release from source with Cargo.
+EOF
+}
+
+case "${1:-install}" in
+  install) ;;
+  help|-h|--help)
+    usage
+    exit 0
+    ;;
+  *)
+    echo "error: unsupported Subconscious Code setup action: $1" >&2
+    usage >&2
+    exit 2
+    ;;
+esac
+
+release_tag() {
+  if [[ -n "${SC_CODE_VERSION:-}" ]]; then
+    printf '%s\n' "${SC_CODE_VERSION#v}"
+    return
+  fi
+  if command -v gh >/dev/null 2>&1; then
+    local tag
+    tag="$(gh release view --repo "$REPOSITORY" --json tagName --jq '.tagName' 2>/dev/null || true)"
+    if [[ -n "$tag" ]]; then
+      printf '%s\n' "${tag#v}"
+      return
+    fi
+  fi
+  if command -v curl >/dev/null 2>&1; then
+    local tag
+    tag="$(curl -fsSL "https://api.github.com/repos/${REPOSITORY}/releases/latest" 2>/dev/null \
+      | sed -n 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' \
+      | head -n 1 || true)"
+    if [[ -n "$tag" ]]; then
+      printf '%s\n' "${tag#v}"
+      return
+    fi
+  fi
+  return 1
+}
+
+install_from_source() {
+  if ! command -v cargo >/dev/null 2>&1; then
+    echo "error: macOS installation currently requires Cargo (Rust 1.89 or newer)" >&2
+    echo "Install Rust from https://rustup.rs, then run: subc sc install" >&2
+    exit 1
+  fi
+
+  local version="${1:-}"
+  local args=(install --locked --git "$REPOSITORY_URL" --bin sc)
+  if [[ -n "$version" ]]; then
+    args+=(--tag "v${version}")
+    echo "Building Subconscious Code v${version} from source..."
+  else
+    echo "No published release is visible yet; building Subconscious Code from the default branch..."
+  fi
+  args+=(rc-cli)
+  CARGO_NET_GIT_FETCH_WITH_CLI=true cargo "${args[@]}"
+}
+
+platform="$(uname -s)"
+version="$(release_tag || true)"
+
+if [[ "$platform" == "Darwin" ]]; then
+  install_from_source "$version"
+  exit 0
+fi
+
+if [[ "$platform" != "Linux" ]]; then
+  echo "error: Subconscious Code automatic installation supports Linux and macOS" >&2
+  exit 1
+fi
+
+if [[ -z "$version" ]]; then
+  echo "error: no published Subconscious Code release is available yet" >&2
+  echo "The release may still be building. Retry subc sc install after it finishes." >&2
+  exit 1
+fi
+
+case "$(uname -m)" in
+  x86_64|amd64) target="x86_64-unknown-linux-musl" ;;
+  aarch64|arm64) target="aarch64-unknown-linux-musl" ;;
+  *)
+    echo "error: unsupported Linux architecture: $(uname -m)" >&2
+    exit 1
+    ;;
+esac
+
+asset="sc-${target}.tar.gz"
+checksum="${asset}.sha256"
+work_dir="$(mktemp -d "${TMPDIR:-/tmp}/subc-sc-install.XXXXXX")"
+cleanup() {
+  rm -f "$work_dir/$asset" "$work_dir/$checksum" "$work_dir/sc"
+  rmdir "$work_dir" 2>/dev/null || true
+}
+trap cleanup EXIT HUP INT TERM
+
+echo "Downloading Subconscious Code v${version} for ${target}..."
+if command -v gh >/dev/null 2>&1 \
+  && gh release view "v${version}" --repo "$REPOSITORY" >/dev/null 2>&1; then
+  gh release download "v${version}" --repo "$REPOSITORY" \
+    --pattern "$asset" --pattern "$checksum" --dir "$work_dir"
+else
+  command -v curl >/dev/null 2>&1 || {
+    echo "error: curl is required to download Subconscious Code" >&2
+    exit 1
+  }
+  release_url="${REPOSITORY_URL}/releases/download/v${version}"
+  curl -fL "${release_url}/${asset}" -o "$work_dir/$asset"
+  curl -fL "${release_url}/${checksum}" -o "$work_dir/$checksum"
+fi
+
+if command -v sha256sum >/dev/null 2>&1; then
+  (cd "$work_dir" && sha256sum --check "$checksum")
+elif command -v shasum >/dev/null 2>&1; then
+  expected="$(awk '{print $1}' "$work_dir/$checksum")"
+  actual="$(shasum -a 256 "$work_dir/$asset" | awk '{print $1}')"
+  [[ "$actual" == "$expected" ]] || {
+    echo "error: Subconscious Code checksum verification failed" >&2
+    exit 1
+  }
+else
+  echo "error: sha256sum or shasum is required to verify the download" >&2
+  exit 1
+fi
+
+tar -xzf "$work_dir/$asset" -C "$work_dir" sc
+mkdir -p "$INSTALL_DIR"
+install -m 0755 "$work_dir/sc" "$INSTALL_DIR/sc"
+echo "Installed Subconscious Code v${version} to $INSTALL_DIR/sc"

package/bin/runbook/subconscious-code/run.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+# Launch Subconscious Code without changing ~/.sc or project settings.
+
+set -euo pipefail
+
+GATEWAY_URL="${GATEWAY_URL:-}"
+API_KEY="${SC_API_KEY:-${API_KEY:-}}"
+MODEL="${MODEL:-subconscious/glm-5.2}"
+
+if [[ -z "$GATEWAY_URL" || -z "$API_KEY" ]]; then
+  echo "error: GATEWAY_URL and API_KEY are required to launch Subconscious Code" >&2
+  exit 1
+fi
+
+export SC_API_KEY="$API_KEY"
+export SC_BASE_URL="${GATEWAY_URL%/}/v1"
+export SC_DLR_URL="${GATEWAY_URL%/}"
+export SC_DLR_ENABLED=true
+export SC_MODEL="$MODEL"
+
+exec sc "$@"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "subconscious-cli",
-  "version": "4.0.14",
-  "description": "CLI for Subconscious — run Claude Code, Codex, OpenCode, DeepSeek Harness, Cursor, Copilot, and Pi",
+  "version": "4.0.15",
+  "description": "CLI for Subconscious — run Subconscious Code, Claude Code, Codex, OpenCode, DeepSeek Harness, Cursor, Copilot, and Pi",
   "bin": {
     "subc": "bin/cli.js"
   },
@@ -33,6 +33,7 @@
     "authentication",
     "profiles",
     "coding-agent",
+    "subconscious-code",
     "claude-code",
     "opencode",
     "codex",