subconscious-cli 4.1.0-windows.0 → 4.1.1

package/README.md

@@ -7,7 +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 marathon
 subc claude
 ```
 
@@ -54,7 +54,7 @@ profile; they do not authenticate, install, configure, or launch anything:
 
 ```bash
 subc claude help
-subc sc help
+subc marathon help
 subc codex help
 subc cursor help
 subc config help
@@ -69,7 +69,7 @@ gateway environment applied for that process. Arguments pass through as usual:
 
 ```bash
 subc claude --continue
-subc sc -- -p "fix the tests"
+subc marathon -- -p "fix the tests"
 subc codex exec "write a test"
 subc opencode
 subc pi
@@ -88,7 +88,7 @@ PowerShell or Command Prompt. The Windows CLI integrations do not require Bash,
 their own dependencies still apply.
 
 ```powershell
-npm.cmd install -g subconscious-cli@windows
+npm.cmd install -g subconscious-cli@latest
 subc.cmd login
 subc.cmd claude
 subc codex
@@ -100,8 +100,8 @@ subc pi
 subc config edit notepad
 ```
 
-This is an opt-in Windows preview; `@latest` remains the stable release. Update
-the preview with `npm.cmd install -g subconscious-cli@windows`.
+Native Windows support is included in the stable CLI starting with 4.1.0.
+Update with `npm.cmd install -g subconscious-cli@latest` or `subc.cmd upgrade --latest`.
 
 If PowerShell's execution policy blocks npm-generated `.ps1` entry points, use
 `npm.cmd` and `subc.cmd` or run the same commands in Command Prompt. No policy
@@ -129,17 +129,18 @@ VS Code's secret store and prompts for its key. Its configuration goes under
 `%APPDATA%\Code\User` (or Code - Insiders/VSCodium). Rerun install after moving
 your Node installation, because hooks record the absolute Node executable path.
 
-To install the native x64 `sc.exe` preview:
+To install the native x64 `sc.exe` (stable releases starting with 0.1.4), clear
+any preview version pin from the current PowerShell session:
 
 ```powershell
-$env:SC_CODE_VERSION = '0.1.4-windows.0'
-subc.cmd sc install
-subc.cmd sc
+Remove-Item Env:SC_CODE_VERSION -ErrorAction SilentlyContinue
+subc.cmd marathon install
+subc.cmd marathon
 ```
 
 The installer requires the selected release's Windows asset and SHA-256
 checksum; it reports a clear error if unavailable and never downloads a Unix
-binary as a fallback. Windows ARM64 binaries are not published in this preview.
+binary as a fallback. Windows ARM64 binaries are not currently published.
 
 Run `npm run test:windows` from `cli/` for the separate Windows suite. The
 Windows CI job also builds/tests the Go TUI. Existing Unix tests and runbooks
@@ -151,7 +152,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 marathon` | 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 |
@@ -194,10 +195,17 @@ 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` detects the operating system and architecture, then downloads
+`subc marathon install` detects the operating system and architecture, then downloads
 and checksum-verifies the matching precompiled release from
 `subconscious-systems/subconscious-code`. Apple Silicon and Intel macOS plus
-x86_64 and ARM64 Linux are supported; Cargo is not required.
+x86_64 and ARM64 Linux and Windows x64 are supported; Cargo is not required.
+
+Starting with CLI 4.1.1, `subc marathon` is the native agent command. On Windows,
+the installer writes `marathon.exe`, avoiding the system `sc.exe` command.
+`subc sc` remains a compatibility alias but never launches Windows service
+control. Older pinned release binaries are also installed as `marathon.exe`.
+Existing `.sc` settings, sessions, and `SC_*` variables are preserved. Unix
+continues using its existing `sc` binary and shell implementation.
 
 `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

package/bin/agents.js

@@ -94,7 +94,7 @@ const AGENTS = registry.agents
   .filter((agent) => agent.cli !== false)
   .map((agent) => {
     const { command, fallback } = resolveInstall(agent.install);
-    return { ...agent, install: command, installFallback: fallback };
+    return { ...agent, bin: agent.binByPlatform?.[process.platform] || agent.bin, install: command, installFallback: fallback };
   });
 const BY_ALIAS = new Map();
 for (const agent of AGENTS) {
@@ -166,14 +166,14 @@ export function parseAgentAction(agent, argv = []) {
 
 const AGENT_HELP = {
   'subconscious-code': {
-    usage: 'subc [-p NAME] sc [help|install] [Subconscious Code arguments...]',
+    usage: 'subc [-p NAME] marathon [help|install] [Marathon arguments...]',
     behavior:
       'Launches the native Subconscious coding agent with the selected profile gateway, credential, and model.',
     options: [
       ['help', 'Show this help'],
       ['install', process.platform === 'win32' ? 'Install a verified Windows release, when published upstream' : 'Install the latest precompiled Linux or macOS release'],
       ['--model MODEL', 'Override the profile model for this launch'],
-      ['ARGS...', 'Pass arguments directly to Subconscious Code'],
+      ['ARGS...', 'Pass arguments directly to Marathon'],
     ],
   },
   'claude-code': {

package/bin/registry.generated.json

@@ -16,9 +16,10 @@
   "agents": [
     {
       "id": "subconscious-code",
-      "command": "sc",
-      "name": "Subconscious Code",
+      "command": "marathon",
+      "name": "Marathon",
       "aliases": [
+        "sc",
         "subconscious-code"
       ],
       "description": "Launch the native Subconscious coding agent with the active profile, gateway, and model.",
@@ -33,10 +34,13 @@
       "protocol": "openai",
       "homepage": "https://github.com/subconscious-systems/subconscious-code",
       "bin": "sc",
+      "binByPlatform": {
+        "win32": "marathon"
+      },
       "install": {
-        "darwin": "subc sc install",
-        "linux": "subc sc install",
-        "win32": "subc sc install"
+        "darwin": "subc marathon install",
+        "linux": "subc marathon install",
+        "win32": "subc marathon install"
       },
       "runbook": {
         "mode": "launch",

package/bin/sessions.js

@@ -21,7 +21,7 @@ export const SESSION_HARNESSES = Object.freeze({
   codex: { name: 'Codex CLI', command: 'codex', portable: true },
   opencode: { name: 'OpenCode', command: 'opencode', portable: true },
   pi: { name: 'Pi', command: 'pi', portable: true },
-  sc: { name: 'Subconscious Code', command: 'sc', portable: false },
+  sc: { name: 'Marathon', command: 'marathon', portable: false },
 });
 
 function cleanText(value) {
@@ -592,7 +592,8 @@ export async function sessionsCommand(argv, options = {}) {
   if (!session) throw new Error(`Session '${key}' was not found. Run subc sessions to refresh the list.`);
   session = await hydrateSession(session);
   const harnessIndex = argv.indexOf('--harness');
-  const targetHarness = harnessIndex >= 0 ? argv[harnessIndex + 1] : session.harness;
+  const requestedHarness = harnessIndex >= 0 ? argv[harnessIndex + 1] : session.harness;
+  const targetHarness = requestedHarness === 'marathon' ? 'sc' : requestedHarness;
   const target = SESSION_HARNESSES[targetHarness];
   if (!target) throw new Error(`Unknown destination harness: ${targetHarness}`);
 

package/bin/windows/agents.js

@@ -21,7 +21,7 @@ export async function runWindowsAgent(agent, argv, dependencies) {
     ? [path.resolve(environment[agent.runbook.installDirEnv] || path.join(os.homedir(), agent.runbook.installDir))] : [];
   environment.PATH = windowsPath([...preferredDirs, ...(environment.PATH || '').split(';'), ...windowsBinDirs(environment)]);
   if (agent.id === 'subconscious-code' && parsed.action === 'install') {
-    if (args.length) throw new Error('Usage: subc sc install');
+    if (args.length) throw new Error('Usage: subc marathon install');
     return finish(await installWindowsAgent(agent.id, environment));
   }
   if (['status', 'uninstall'].includes(parsed.action)) {

package/bin/windows/install.js

@@ -16,7 +16,7 @@ function npmInstall(command) {
 export function windowsInstallSpec(id, env = process.env) {
   const install = registry.agents.find(agent => agent.id === id)?.install;
   const command = typeof install === 'object' ? install.win32 : undefined;
-  if (id === 'subconscious-code') return { nativeRelease: true, display: 'subc sc install' };
+  if (id === 'subconscious-code') return { nativeRelease: true, display: 'subc marathon install' };
   if (!command) return null; // Never fall back to a Linux installer.
   if (id === 'claude-code') {
     const primary = powershellCommand("$ErrorActionPreference = 'Stop'; Invoke-RestMethod 'https://claude.ai/install.ps1' | Invoke-Expression; if (-not $?) { exit 1 }", env);
@@ -30,9 +30,11 @@ export function windowsInstallSpec(id, env = process.env) {
 export function windowsReleaseAsset(release, arch = process.arch) {
   const target = { x64: 'x86_64-pc-windows-msvc', arm64: 'aarch64-pc-windows-msvc' }[arch];
   if (!target) throw new Error(`Subconscious Code does not support Windows architecture ${arch}`);
-  const names = [`sc-${target}.zip`, `sc-${target}.exe`];
-  const asset = release.assets?.find(asset => names.includes(asset.name));
-  if (!asset) throw new Error(`Subconscious Code ${release.tag_name || 'latest'} has no published native Windows ${arch} binary. The CLI can launch an installed sc.exe, but the upstream release must include a Windows build before subc sc install can install it.`);
+  // Pinned older releases are installed under the new executable name too.
+  // Never resolve or overwrite Windows' own sc.exe.
+  const names = [`marathon-${target}.zip`, `marathon-${target}.exe`, `sc-${target}.zip`, `sc-${target}.exe`];
+  const asset = names.map(name => release.assets?.find(asset => asset.name === name)).find(Boolean);
+  if (!asset) throw new Error(`Marathon ${release.tag_name || 'latest'} has no published native Windows ${arch} binary for subc marathon install.`);
   const checksum = release.assets.find(candidate => candidate.name === `${asset.name}.sha256`);
   if (!checksum) throw new Error(`The Windows release is missing ${asset.name}.sha256; refusing an unverified installation.`);
   return { asset, checksum };
@@ -52,21 +54,22 @@ export async function installWindowsSC(env, { fetchImpl = fetch, run = runWindow
     if (!response.ok) throw new Error(`Download failed (HTTP ${response.status}): ${asset.name}`);
     return Buffer.from(await response.arrayBuffer());
   };
-  log(`Downloading Subconscious Code ${release.tag_name} for Windows ${arch}...`);
+  log(`Downloading Marathon ${release.tag_name} for Windows ${arch}...`);
   const [binary, checksumText] = await Promise.all([download(asset), download(checksum)]);
   const expected = checksumText.toString('utf8').trim().split(/\s+/)[0];
   if (!/^[a-f0-9]{64}$/i.test(expected) || createHash('sha256').update(binary).digest('hex') !== expected.toLowerCase()) throw new Error('Subconscious Code checksum verification failed');
   const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'subc-sc-install-'));
   const installDir = path.resolve(env.SC_INSTALL_DIR || path.join(home, '.local', 'bin'));
-  const destination = path.join(installDir, 'sc.exe');
-  const staging = path.join(installDir, `sc-${randomUUID()}.tmp`);
+  const destination = path.join(installDir, 'marathon.exe');
+  const staging = path.join(installDir, `marathon-${randomUUID()}.tmp`);
   try {
-    const extracted = path.join(dir, 'sc.exe');
+    const extracted = path.join(dir, 'marathon.exe');
     if (asset.name.endsWith('.zip')) {
       const archive = path.join(dir, 'release.zip');
       await fs.writeFile(archive, binary, { flag: 'wx' });
       // Extract only the exact root executable. No archive-controlled paths.
-      const spec = powershellCommand("$ErrorActionPreference = 'Stop'; Add-Type -AssemblyName System.IO.Compression.FileSystem; $z = [IO.Compression.ZipFile]::OpenRead($env:SUBC_ARCHIVE); try { $e = $z.GetEntry('sc.exe'); if ($null -eq $e) { throw 'Archive has no root sc.exe' }; [IO.Compression.ZipFileExtensions]::ExtractToFile($e, $env:SUBC_EXTRACTED, $false) } finally { $z.Dispose() }", { ...env, SUBC_ARCHIVE: archive, SUBC_EXTRACTED: extracted });
+      const executable = asset.name.startsWith('marathon-') ? 'marathon.exe' : 'sc.exe';
+      const spec = powershellCommand("$ErrorActionPreference = 'Stop'; Add-Type -AssemblyName System.IO.Compression.FileSystem; $z = [IO.Compression.ZipFile]::OpenRead($env:SUBC_ARCHIVE); try { $e = $z.GetEntry($env:SUBC_EXECUTABLE); if ($null -eq $e) { throw 'Archive has no expected root executable' }; [IO.Compression.ZipFileExtensions]::ExtractToFile($e, $env:SUBC_EXTRACTED, $false) } finally { $z.Dispose() }", { ...env, SUBC_ARCHIVE: archive, SUBC_EXTRACTED: extracted, SUBC_EXECUTABLE: executable });
       if (await run(spec.command, spec.args, { env: spec.env })) throw new Error('Could not extract the Windows release');
     } else await fs.writeFile(extracted, binary, { flag: 'wx' });
     const magic = (await fs.readFile(extracted)).subarray(0, 2).toString('ascii');
@@ -74,7 +77,7 @@ export async function installWindowsSC(env, { fetchImpl = fetch, run = runWindow
     await fs.mkdir(installDir, { recursive: true });
     await fs.copyFile(extracted, staging);
     await fs.rename(staging, destination);
-    log(`Installed ${destination}. Run subc sc to launch it.`);
+    log(`Installed ${destination}. Run subc marathon to launch it.`);
     return 0;
   } finally {
     await fs.rm(staging, { force: true });

package/bin/windows/launch.js

@@ -19,7 +19,7 @@ export async function windowsLaunch(id, argv, env, { tempRoot = os.tmpdir() } =
   const { model, base, key } = connection(env, keyName);
   const childEnv = { ...env, SUBCONSCIOUS_API_KEY: key, SUBCONSCIOUS_GATEWAY_URL: base };
   if (id === 'subconscious-code') {
-    return { command: 'sc', args: argv, env: { ...childEnv, SC_API_KEY: key, SC_BASE_URL: `${base}/v1`, SC_DLR_URL: base, SC_DLR_ENABLED: 'true', SC_MODEL: model } };
+    return { command: 'marathon', args: argv, env: { ...childEnv, SC_API_KEY: key, SC_BASE_URL: `${base}/v1`, SC_DLR_URL: base, SC_DLR_ENABLED: 'true', SC_MODEL: model } };
   }
   if (id === 'pi') return { command: 'pi', args: ['--provider', 'subconscious', '--model', model, ...argv], env: childEnv };
   if (id === 'opencode') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "subconscious-cli",
-  "version": "4.1.0-windows.0",
+  "version": "4.1.1",
   "description": "CLI for Subconscious — run Subconscious Code, Claude Code, Codex, OpenCode, DeepSeek Harness, Cursor, Copilot, and Pi",
   "bin": {
     "subc": "bin/cli.js"