subconscious-cli 4.0.18 → 4.1.0

package/README.md

@@ -35,7 +35,7 @@ subc <agent> uninstall
 Running `subc` with no arguments in a terminal opens the native Go TUI. Use
 the arrow keys and Enter to launch agents or manage the active profile, `p` to
 switch profiles, and `q` to quit. The menu includes dedicated **Usage**,
-**Create profile**, **Set default model**, **Set subagent model**,
+**Create profile**, **Coding sessions**, **Set default model**, **Set subagent model**,
 **Update base URL**, and **Update platform URL** actions.
 Model and URL changes are validated and saved to the active profile without
 leaving the TUI.
@@ -76,6 +76,76 @@ subc pi
 subc dsh
 ```
 
+## Native Windows support
+
+Windows has its own implementation in `cli/bin/windows/`, selected only when
+Node runs on Windows. macOS/Linux continue to use the existing, unchanged shell
+runbooks. WSL continues to use the Linux implementation.
+
+Use Node.js 22 or 24 and Windows PowerShell 5.1+ (included with Windows), from either
+PowerShell or Command Prompt. The Windows CLI integrations do not require Bash,
+`jq`, `curl`, or WSL. The agents themselves must support your Windows version;
+their own dependencies still apply.
+
+```powershell
+npm.cmd install -g subconscious-cli@latest
+subc.cmd login
+subc.cmd claude
+subc codex
+subc opencode
+subc dsh
+subc cursor install
+subc copilot install
+subc pi
+subc config edit notepad
+```
+
+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
+change is required. Pi must already be installed; other terminal agents offer
+their Windows installer when missing in an interactive terminal.
+
+Native executables and standard npm `.cmd` shims are supported. The launcher
+invokes the underlying executable or Node entry point directly, preserving
+JSON, quotes, Unicode, and multiline arguments. It checks the user's `.local\bin`,
+npm globals, WinGet links, and the system-profile `.local\bin` location reported
+by some elevated Claude installations. It does not change your global PATH.
+Custom batch wrappers are rejected with guidance to use a native executable or
+standard npm package.
+
+Login, saved profiles, model discovery, session browsing/resume, self-update,
+and the native TUI use Windows paths and processes. Profile editing defaults to
+Notepad, honors `VISUAL`/`EDITOR`, and supports `code`/`code-insiders` with `--wait`.
+The existing profile location remains `%USERPROFILE%\.subconscious`.
+
+Cursor, Copilot, Codex, and Pi setup use native JSON merges and Node hooks. Other
+providers and hooks are preserved; malformed configuration is left unchanged.
+Hook credentials are stored in `subconscious-windows.json` within the agent's
+user directory; treat that file as a secret. Copilot's model provider still uses
+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` (stable releases starting with 0.1.4), clear
+any preview version pin from the current PowerShell session:
+
+```powershell
+Remove-Item Env:SC_CODE_VERSION -ErrorAction SilentlyContinue
+subc.cmd sc install
+subc.cmd sc
+```
+
+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 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
+remain separate and unchanged.
+
 ## Supported agents
 
 The packaged integrations live in `cli/bin/runbook`.
@@ -91,6 +161,35 @@ 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 |
 
+## Sessions and cross-harness handoff
+
+Run `subc` and choose **Coding sessions**, or list the same local catalog from
+the shell:
+
+```bash
+subc sessions
+subc sessions resume claude:SESSION_ID
+subc sessions resume claude:SESSION_ID --harness codex
+subc sessions resume codex:SESSION_ID --harness opencode
+```
+
+The catalog discovers recent sessions written locally by Claude Code, Codex,
+OpenCode, Pi, and Subconscious Code. It shows each session's originating
+harness, title, last activity, project directory, and model when the harness
+records one. Selecting the original harness uses its native resume mechanism.
+
+Selecting Claude Code, Codex, OpenCode, or Pi as a different destination starts
+a new session in the original project directory with a portable handoff. The
+handoff is limited to the newest 24 user/assistant text messages and 24,000
+characters. Tool payloads, tool results, system prompts, and hidden reasoning
+are not copied. Source transcripts remain owned by their original harness and
+are never rewritten.
+
+Cursor and GitHub Copilot sessions are not listed because their IDE-owned
+conversation stores do not expose a stable local resume interface. A session
+whose local transcript is missing remains available for native resume but does
+not offer cross-harness destinations.
+
 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

package/bin/agents.js

@@ -19,6 +19,7 @@ import path from 'node:path';
 import readline from 'node:readline';
 import { fileURLToPath } from 'node:url';
 import { c } from './colors.js';
+import { runWindowsAgent } from './windows/agents.js';
 import { getApiKey } from './auth.js';
 import {
   isUnsetSetting,
@@ -170,7 +171,7 @@ const AGENT_HELP = {
       'Launches the native Subconscious coding agent with the selected profile gateway, credential, and model.',
     options: [
       ['help', 'Show this help'],
-      ['install', 'Install the latest precompiled Linux or macOS release'],
+      ['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'],
     ],
@@ -976,6 +977,14 @@ export async function runAgent(agent, argv, options = {}) {
     return 0;
   }
 
+  if (process.platform === 'win32') {
+    return runWindowsAgent(agent, argv, {
+      profile, parseAgentAction, extractModel, requireApiKey,
+      resolvedModelsForLaunch, selectLaunchModel, runbookEnv,
+      minimumClaudeVersion: MIN_CLAUDE_CODE_VERSION, parseClaudeVersion, claudeVersionNeedsUpgrade,
+    });
+  }
+
   const parsed = parseAgentAction(agent, argv);
   if (parsed.action !== 'launch') {
     if (!agent.runbook?.setupScript) {

package/bin/auth.js

@@ -18,6 +18,7 @@
 import http from 'node:http';
 import crypto from 'node:crypto';
 import { exec } from 'node:child_process';
+import { openWindowsBrowser } from './windows/process.js';
 import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
@@ -135,6 +136,12 @@ export function isLoginMissing(status) {
 // ── Browser opener ──────────────────────────────────────────────────────
 
 function openBrowser(url) {
+  if (process.platform === 'win32') {
+    void openWindowsBrowser(url).then(code => {
+      if (code) throw new Error('Browser could not be opened');
+    }).catch(() => console.log(`Please open this URL manually:\n\n  ${url}\n`));
+    return;
+  }
   const cmd =
     process.platform === 'darwin'
       ? `open "${url}"`

package/bin/cli.js

@@ -44,6 +44,7 @@ import {
 import { resolveModelCatalog } from './models.js';
 import { showUpdateNotice } from './update-check.js';
 import { runTui } from './tui.js';
+import { sessionsCommand } from './sessions.js';
 import { printUsageHelp, usageCommand } from './usage.js';
 
 function isHelpArg(arg) {
@@ -75,6 +76,9 @@ function printHelp() {
     ${c.cyan}config${c.reset}       List profiles, or show/edit one with ${c.dim}-p${c.reset}
     ${c.cyan}models${c.reset}       List available Subconscious models
 
+  ${c.bold}Sessions${c.reset}
+    ${c.cyan}sessions${c.reset}     Browse and resume local coding sessions across harnesses
+
   ${c.bold}Coding agents${c.reset}
 ${agents}
 
@@ -92,6 +96,8 @@ ${agents}
     ${c.dim}$${c.reset} subc config help
     ${c.dim}$${c.reset} subc -p staging config
     ${c.dim}$${c.reset} subc config edit vim
+    ${c.dim}$${c.reset} subc sessions
+    ${c.dim}$${c.reset} subc sessions resume claude:SESSION_ID --harness codex
     ${c.dim}$${c.reset} subc usage
     ${c.dim}$${c.reset} subc usage --json
     ${c.dim}$${c.reset} subc claude
@@ -179,6 +185,17 @@ Usage:
 
 List available Subconscious models. The default is the profile MODEL,
 or the first live catalog model if MODEL is UNSET.
+`,
+  sessions: `
+Usage:
+  subc sessions
+  subc sessions resume <session-key>
+  subc sessions resume <session-key> --harness <claude|codex|opencode|pi>
+  subc sessions help
+
+List locally stored sessions from supported coding harnesses. Resuming with the
+original harness uses its native session. Choosing another harness starts a new
+session with a bounded, text-only handoff from the source conversation.
 `,
 };
 
@@ -355,6 +372,17 @@ async function main() {
     return;
   }
 
+  if (command === 'sessions') {
+    if (isHelpArg(args[1])) {
+      console.log(COMMAND_HELP.sessions);
+      return;
+    }
+    const profile = await loadProfile(profileName);
+    requireNamedProfile(profile);
+    await sessionsCommand(args.slice(1), { profile });
+    return;
+  }
+
   if (command === 'upgrade') {
     if (isHelpArg(args[1])) {
       console.log(COMMAND_HELP.upgrade);

package/bin/profiles.js

@@ -7,6 +7,7 @@
  */
 
 import { spawn, execFileSync } from 'node:child_process';
+import { windowsEditor, runWindows } from './windows/process.js';
 import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
@@ -658,7 +659,7 @@ export function validateSettingValue(setting, value) {
   return null;
 }
 
-const ALLOWED_EDITORS = new Set(['vim', 'nano']);
+const ALLOWED_EDITORS = new Set(process.platform === 'win32' ? ['notepad', 'code', 'code-insiders', 'vim', 'nano'] : ['vim', 'nano']);
 
 function commandExists(bin) {
   try {
@@ -695,6 +696,12 @@ async function editProfile(profileName, requestedEditor) {
   }
 
   const profile = await ensureProfile(profileName);
+  if (process.platform === 'win32') {
+    const { command, args } = windowsEditor(requestedEditor);
+    const code = await runWindows(command, [...args, profile.path]);
+    if (code) process.exitCode = code;
+    return;
+  }
   const { cmd, args } = resolveEditor(requestedEditor);
   await new Promise((resolve, reject) => {
     const child = spawn(cmd, [...args, profile.path], { stdio: 'inherit' });
@@ -714,8 +721,8 @@ Usage:
   subc config
   subc config help
   subc -p NAME config
-  subc config edit [vim|nano]
-  subc -p NAME config edit [vim|nano]
+  subc config edit [${process.platform === 'win32' ? 'notepad|code|code-insiders|vim|nano' : 'vim|nano'}]
+  subc -p NAME config edit [${process.platform === 'win32' ? 'notepad|code|code-insiders|vim|nano' : 'vim|nano'}]
   subc config [show|path|list|create|delete]
               [--gateway-url URL] [--platform-url URL] [--api-key KEY]
               [--model MODEL|UNSET]
@@ -723,7 +730,7 @@ Usage:
 
   subc config                      List every profile and its file path
   subc -p NAME config              Print that profile's path and env file
-  subc config edit                 Open the selected profile in $VISUAL, $EDITOR, vim, or nano
+  subc config edit                 Open the selected profile in ${process.platform === 'win32' ? 'VISUAL, EDITOR, or Notepad' : '$VISUAL, $EDITOR, vim, or nano'}
   subc config edit vim             Open the selected profile in vim
   subc config edit nano            Open the selected profile in nano
   subc config path                 Print the selected profile path

package/bin/registry.generated.json

@@ -35,7 +35,8 @@
       "bin": "sc",
       "install": {
         "darwin": "subc sc install",
-        "linux": "subc sc install"
+        "linux": "subc sc install",
+        "win32": "subc sc install"
       },
       "runbook": {
         "mode": "launch",