claude-code-infinite 1.0.25 → 1.0.27

package/README.md

@@ -4,7 +4,14 @@
 
 # Claude Code Infinite
 
-Memory for long-running agents. Claude Code Infinite indexes your Claude Code sessions with
+<p align="center">
+  <a href="#long-session-benchmark"><img width="640" alt="Long-session benchmark, Claude Opus 5.5, graded blind: MemTree 69% at 39M tokens per run, full context 69% at 113M, /compact 49% at 17M" src="https://raw.githubusercontent.com/crizCraig/claude-code-infinite/main/docs/images/benchmark-chart.png"></a>
+</p>
+<p align="center"><sub>Long-session benchmark on a 775k-token Claude Code session (Claude Opus 5.5, graded blind):
+MemTree matched full context at 69% with a third of the tokens; <code>/compact</code> scored 49%.
+<a href="#long-session-benchmark">Full results</a></sub></p>
+
+Infinite context for Claude Code: memory for long-running agents. Claude Code Infinite indexes your Claude Code sessions with
 [MemTree](https://memtree.dev) so their history can be easily searched, navigated, and understood,
 by you and by Claude, within a session and across all of them.
 
@@ -30,14 +37,8 @@ work: your priorities, the nuances of your projects, your company and your envir
 orchestrate dozens of subagents on your behalf.
 
 > [!IMPORTANT]
-> Requires a Claude Pro or Max subscription.
-
-<p align="center">
-  <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/crizCraig/claude-code-infinite/main/docs/images/benchmark-dark.svg">
-    <img width="600" alt="Long-session benchmark, judged score out of 100: Claude Code Infinite 69, full context 69, /compact 49" src="https://raw.githubusercontent.com/crizCraig/claude-code-infinite/main/docs/images/benchmark-light.svg">
-  </picture>
-</p>
+> Install [Claude Code in your terminal](#setup) and sign in with Claude Pro or Max
+> before running `ccc`. The Claude desktop app isn't enough.
 
 ## Search across sessions
 
@@ -82,19 +83,32 @@ tokens; `/compact`'s exclude the one-time `/compact` step. This is one task fami
 
 ## Requirements
 
+* **[Claude Code in your terminal](https://code.claude.com/docs/en/quickstart), signed in
+  with Claude Pro or Max.** The Claude desktop app isn't enough: `ccc` needs the terminal
+  version.
 * [node.js 20.3 or newer](https://nodejs.org/en/download/)
-* [Claude Code (the terminal version)](https://code.claude.com/docs/en/quickstart)
-* **A Claude Pro or Max subscription**
 
-<sub>Also works with an Anthropic API key, but that's far costlier than Pro or Max.</sub>
+<sub>Also works with an Anthropic API key that has credit, but that's far costlier than Pro or Max.</sub>
 
 ## Setup
 
-1. Install (Node ≥ 20.3; no git needed)
+1. **Install Claude Code first** and sign in with Claude Pro or Max. The Claude desktop app
+  isn't enough: `ccc` needs the terminal version.
+  ```powershell
+  # Windows PowerShell
+  irm https://claude.ai/install.ps1 | iex
+  ```
+  ```bash
+  # macOS / Linux
+  curl -fsSL https://claude.ai/install.sh | bash
+  ```
+  Open a new terminal and run `claude` once to sign in
+  ([help](#claude-code-isnt-installed)).
+2. Install Claude Code Infinite (Node ≥ 20.3; no git needed)
   ```bash
   npm install -g claude-code-infinite
   ```
-2. Run Claude Code Infinite with
+3. Run it from your project folder
   ```bash
   ccc
   ```
@@ -136,7 +150,7 @@ Environment variables, set when launching `ccc`:
 | `CCC_COMPACT_TARGET=500k` | Compaction target for every session (useful for headless `-p` runs); `off` starts every session with compaction off. |
 | `CCC_MEMTREE_MCP=0` | Turns off the `memtree` MCP tools ([details](#memory-tools)), in interactive and headless (`-p`) runs. |
 | `CCC_MEMTREE_LINK` | Where the MemTree link appears: `turn` (default, end of a turn with a new page), `message` (under every reply), `stop` (end of every turn), `success` (only after an optimized turn), or `off`. |
-| `CCC_AUTO_COMPACT=1` | Restores Claude Code's own auto-compaction setting ([details](#claude-code-auto-compaction)). |
+| `CCC_AUTO_COMPACT=1` | Restores Claude Code's own auto-compaction and idle compaction settings ([details](#claude-code-auto-compaction)). |
 | `CCC_NO_UPDATE_CHECK=1` | Turns off the update check, and with it automatic updates ([details](#upgrading)). |
 | `CCC_DISABLE_AUTOUPDATE=1` | Keeps the update notice but never installs ([details](#automatic-updates)). |
 | `CCC_NO_DIAGNOSTICS=1` | Turns off diagnostics ([details](#diagnostics)). So do `DO_NOT_TRACK=1`, Claude Code's `DISABLE_TELEMETRY=1` or `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`, and `"diagnostics": false` in `~/.claude-code-infinite/config.json`. |
@@ -148,6 +162,12 @@ kitty, VS Code, JetBrains, Windows Terminal); elsewhere you get the plain URL.
 
 `ccc` disables Claude Code's automatic conversation compaction for the Claude process it launches. MemTree manages the context sent to the model, so letting Claude Code independently summarize the full local transcript can compact a conversation MemTree already reduced. Manual `/compact` remains available.
 
+That includes idle compaction (Claude Code 2.1.286 and later), which summarizes a
+long conversation while you're away, just before the prompt cache expires
+("Compacted while idle, before the prompt cache expired"). The
+`DISABLE_AUTO_COMPACT=1` that `ccc` sets turns it off too, so you don't need
+`"idleCompaction": false` in your settings.
+
 Claude Code 2.1.219 also recommends “Resume from summary” for any old session
 above a fixed 100k-token threshold, even when the active model has a 1M window
 and auto-compaction is disabled. `ccc` suppresses that resume-time
@@ -168,7 +188,8 @@ On `ccc --resume <id>`, `ccc` backs the transcript up to
 recorded usage to half the window, so the next message is sent and MemTree
 compresses it.
 
-To restore Claude Code's native auto-compaction setting for one invocation, use:
+To restore Claude Code's native auto-compaction and idle compaction settings for one
+invocation, use:
 
 ```bash
 CCC_AUTO_COMPACT=1 ccc
@@ -202,6 +223,10 @@ Claude Code ──▶ localhost proxy (ccc)
 
 - versions (ccc, Claude Code, Node), how ccc was installed (npm, npx, linked), OS and CPU
   architecture, terminal type and locale;
+- how Claude Code is signed in, as a type only (Claude.ai subscription, API key, Bedrock,
+  Vertex, Foundry), the plan's tier name when Claude Code records one (Pro, Max, Team), the main
+  model's context window ccc uses (200k or 1M), and where Claude Code was found (on PATH,
+  its installer's folder, npm, winget);
 - lifecycle events (first run, sign-in prompt shown, key accepted or rejected, session start,
   the MemTree-paused notice shown, update hint or background update result);
 - errors as codes, status numbers, sizes and timings (an Anthropic 401, a MemTree 402, a
@@ -371,6 +396,24 @@ publish.yml still tests that tag but skips publishing, since the version is alre
 
 `ccc` never touches your Anthropic credentials — Claude Code manages its own login exactly as it does without `ccc`. If you see auth errors, fix them the vanilla way: run `/login` inside Claude Code (or `claude` directly) and re-authenticate.
 
+### "Claude Code isn't installed"
+
+`ccc` runs Claude Code, so it has to be installed and signed in first. `ccc` finds it on
+PATH and, failing that, where its installers put it (`%USERPROFILE%\.local\bin`,
+`%APPDATA%\npm`, winget's folder and your saved user PATH on Windows; `~/.local/bin`,
+`~/.claude/local` and Homebrew elsewhere), so a terminal opened before the install works
+too. If it is not there, install it with the official command (Windows PowerShell:
+`irm https://claude.ai/install.ps1 | iex`; macOS/Linux:
+`curl -fsSL https://claude.ai/install.sh | bash`), open a new terminal, run `claude` once
+to sign in, then run
+`ccc` again, from your project folder.
+
+### "This API key has no credit"
+
+`ccc` isn't free Claude: it runs your own Claude Code with your own Anthropic login. When
+Anthropic refuses an API key for having no credit, `ccc` says so as it exits. Sign in with
+a Claude Pro or Max plan (`claude`, then `/login`) or add credit to the key.
+
 ### MemTree degraded / passthrough mode
 
 If you see an inline "⚠ MemTree degraded — this turn ran uncompressed" notice, the compression API is unreachable or your MemTree key is invalid/expired. Your session keeps working uncompressed. Check your key at [polychat.co](https://polychat.co/auth?memtree=true), or delete it from `~/.claude-code-infinite/config.json` and re-run `ccc` to re-enter it.
@@ -423,15 +466,24 @@ at once; after an hour `ccc` shows the update line instead, and deleting
 
 **When it doesn't.** `ccc` updates itself only when it is a plain global npm install
 (`npm i -g`) whose files are in `npm root -g` and writable by you. It never uses `sudo`.
-In every other case it only shows the update line:
+In every other case it only shows the update line, with the command that fits the install:
 
-- `npm link`ed or git checkouts (a development copy is never touched),
+- `npm link`ed or git checkouts: a development copy is never touched, and the line says to
+  `git pull && npm run build` in a git checkout, or to update and rebuild the linked folder
+  otherwise (`npm i -g` would replace the link with the published package),
 - `npx` and project-local installs,
-- pnpm, yarn, bun and Volta global installs (update with your tool's own command),
+- pnpm, yarn, bun and Volta global installs (the line gives your tool's own command),
 - a global prefix that needs `sudo` to write, or `ccc` running as root,
-- Windows,
 - print (`-p`) and non-TTY runs, which never install anything.
 
+**Windows.** The install starts as `ccc` exits rather than during the session: the
+background installer waits for that `ccc` to be gone before npm runs, so npm does not
+rewrite files under the session that started it. The banner says so (`• ccc X is
+available … · installs when you exit ccc`). A `ccc` started while it installs says
+"Finishing a ccc update…" and waits for it (usually seconds, at most two minutes), then runs the new
+version. Closing the terminal window usually counts as exiting too. By hand:
+`npm i -g claude-code-infinite@latest`.
+
 `ccc --debug` prints which install method was detected and what it decided.
 
 **Sessions running during an update.** npm replaces `ccc`'s files while other `ccc`

package/dist/auto-update-runner.d.ts

@@ -19,6 +19,13 @@
  * --no-fund --no-audit` (argv, never a shell); confirm the package.json now
  * says that version. Any failure is recorded with a short reason.
  *
+ * Windows (waitForPid): the runner first waits for the ccc that started it to
+ * exit, so npm does not rewrite files under that session; npm
+ * runs as `node npm-cli.js` (npmArgs), and its "group" is npm's own pid,
+ * stopped with `taskkill /T /F` (its whole process tree) instead of signals
+ * to a POSIX process group. Unlike a POSIX group, a descendant that outlives
+ * npm is not tracked there (ccc and its dependency have no install scripts).
+ *
  * Bounded: each npm command runs in its own process group, recorded in the
  * lock entry. When it ends (or times out) the whole group is reaped: SIGTERM,
  * then SIGKILL, until no member is left, so a descendant that outlives npm
@@ -31,6 +38,12 @@
 /** What ccc passes the runner, as JSON in argv[1]. */
 export interface RunnerConfig {
     npm: string;
+    /** Arguments before npm's own: Windows runs `node npm-cli.js`. */
+    npmArgs?: string[];
+    /** Windows: wait for this pid (the launching ccc) to exit before installing. */
+    waitForPid?: number;
+    /** Test-only: how long to wait for waitForPid (default 60 s). */
+    waitForPidMs?: number;
     packageName: string;
     version: string;
     packageDir: string;

package/dist/auto-update-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-update-runner.d.ts","sourceRoot":"","sources":["../src/auto-update-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,aAAa,QAmRzB,CAAC"}
+{"version":3,"file":"auto-update-runner.d.ts","sourceRoot":"","sources":["../src/auto-update-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,aAAa,QAwTzB,CAAC"}

package/dist/auto-update-runner.js

@@ -19,6 +19,13 @@
  * --no-fund --no-audit` (argv, never a shell); confirm the package.json now
  * says that version. Any failure is recorded with a short reason.
  *
+ * Windows (waitForPid): the runner first waits for the ccc that started it to
+ * exit, so npm does not rewrite files under that session; npm
+ * runs as `node npm-cli.js` (npmArgs), and its "group" is npm's own pid,
+ * stopped with `taskkill /T /F` (its whole process tree) instead of signals
+ * to a POSIX process group. Unlike a POSIX group, a descendant that outlives
+ * npm is not tracked there (ccc and its dependency have no install scripts).
+ *
  * Bounded: each npm command runs in its own process group, recorded in the
  * lock entry. When it ends (or times out) the whole group is reaped: SIGTERM,
  * then SIGKILL, until no member is left, so a descendant that outlives npm
@@ -36,7 +43,9 @@ const path = require("node:path");
 
 const VERSION_RE = /^(0|[1-9]\d{0,8})\.(0|[1-9]\d{0,8})\.(0|[1-9]\d{0,8})$/;
 const ROOT_TIMEOUT_MS = 60000;
+const IS_WINDOWS = process.platform === "win32";
 const cfg = JSON.parse(process.argv[1]);
+const WAIT_FOR_PID_MS = cfg.waitForPidMs || 60000;
 const KILL_GRACE_MS = cfg.killGraceMs || 10000;
 const PIPE_GRACE_MS = cfg.pipeGraceMs || 5000;
 const ENTRY = path.join(cfg.lockDir, cfg.token + ".json");
@@ -49,7 +58,8 @@ let stopping = null;
 
 // Hard deadline: whatever npm does, this process kills its group, records a
 // result and exits, so a live holder never outlasts the lock's stale age.
-const DEADLINE_MS = ROOT_TIMEOUT_MS + cfg.timeoutMs + 2 * (2 * KILL_GRACE_MS + 2 * PIPE_GRACE_MS) + 30000;
+const DEADLINE_MS = ROOT_TIMEOUT_MS + cfg.timeoutMs + 2 * (2 * KILL_GRACE_MS + 2 * PIPE_GRACE_MS) +
+  (cfg.waitForPid ? WAIT_FOR_PID_MS : 0) + 30000;
 setTimeout(() => abort("runner deadline passed"), DEADLINE_MS);
 for (const signal of ["SIGTERM", "SIGINT", "SIGHUP"]) {
   process.on(signal, () => abort("runner stopped by " + signal));
@@ -65,19 +75,51 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-function groupAlive(pgid) {
+function pidAlive(pid) {
   try {
-    process.kill(-pgid, 0);
+    process.kill(pid, 0);
     return true;
   } catch (err) {
     return err.code === "EPERM";
   }
 }
 
+// Windows has no process groups: the "group" is npm's pid and its tree.
+function groupAlive(pgid) {
+  return pidAlive(IS_WINDOWS ? pgid : -pgid);
+}
+
 function signalGroup(pgid, signal) {
+  if (IS_WINDOWS) {
+    try {
+      const taskkill = path.join(process.env.SystemRoot || "C:\\Windows", "System32", "taskkill.exe");
+      require("node:child_process").spawnSync(taskkill, ["/PID", String(pgid), "/T", "/F"], {
+        stdio: "ignore", windowsHide: true, timeout: 10000,
+      });
+    } catch {}
+    return;
+  }
   try { process.kill(-pgid, signal); } catch {}
 }
 
+async function awaitLauncherExit() {
+  if (!cfg.waitForPid) return true;
+  const until = Date.now() + WAIT_FOR_PID_MS;
+  while (pidAlive(cfg.waitForPid)) {
+    if (Date.now() >= until || stopping) return false;
+    await sleep(100);
+  }
+  return true;
+}
+
+function npmArgs(args) {
+  return (cfg.npmArgs || []).concat(args);
+}
+
+function samePath(a, b) {
+  return a !== null && b !== null && (IS_WINDOWS ? a.toLowerCase() === b.toLowerCase() : a === b);
+}
+
 async function goneWithin(pgid, ms) {
   const until = Date.now() + ms;
   while (groupAlive(pgid)) {
@@ -168,6 +210,7 @@ function run(command, args, timeoutMs, capture) {
         env: process.env,
         stdio: ["ignore", "pipe", "pipe"],
         detached: true,
+        windowsHide: true,
       });
     } catch (err) {
       recordGroup(null, false);
@@ -225,20 +268,21 @@ function describe(result, what) {
 
 async function install() {
   if (!VERSION_RE.test(cfg.version)) throw new Error("refusing version " + JSON.stringify(cfg.version));
-  const rootRun = await runReaped(cfg.npm, ["root", "--global"], ROOT_TIMEOUT_MS, true);
+  if (!(await awaitLauncherExit())) throw new Error(stopping || "ccc did not exit");
+  const rootRun = await runReaped(cfg.npm, npmArgs(["root", "--global"]), ROOT_TIMEOUT_MS, true);
   const rootFailure = describe(rootRun, "npm root -g");
   if (rootFailure) throw new Error(rootFailure);
   const npmRoot = realpath(rootRun.out.trim());
-  if (npmRoot === null || npmRoot !== realpath(cfg.npmRoot)) {
+  if (npmRoot === null || !samePath(npmRoot, realpath(cfg.npmRoot))) {
     throw new Error("npm root -g is " + rootRun.out.trim() + ", not " + cfg.npmRoot + ": wrong prefix");
   }
   const entry = path.join(npmRoot, cfg.packageName);
   if (fs.lstatSync(entry).isSymbolicLink()) throw new Error(entry + " is a symlink (npm link)");
-  if (realpath(entry) !== realpath(cfg.packageDir)) throw new Error(entry + " is not this ccc");
+  if (!samePath(realpath(entry), realpath(cfg.packageDir))) throw new Error(entry + " is not this ccc");
   const spec = cfg.packageName + "@" + cfg.version;
   const args = ["install", "--global", "--prefix=" + cfg.prefix, spec, "--no-fund", "--no-audit"];
   note("npm " + args.join(" "));
-  const failure = describe(await runReaped(cfg.npm, args, cfg.timeoutMs, false), "npm install");
+  const failure = describe(await runReaped(cfg.npm, npmArgs(args), cfg.timeoutMs, false), "npm install");
   if (failure) throw new Error(failure);
   const pkg = JSON.parse(fs.readFileSync(path.join(cfg.packageDir, "package.json"), "utf8"));
   if (pkg.version !== cfg.version) throw new Error("installed version is " + pkg.version);

package/dist/auto-update-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"auto-update-runner.js","sourceRoot":"","sources":["../src/auto-update-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAuBH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmRtC,CAAC"}
+{"version":3,"file":"auto-update-runner.js","sourceRoot":"","sources":["../src/auto-update-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AA6BH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwTtC,CAAC"}

package/dist/auto-update-setup.d.ts

@@ -2,10 +2,10 @@
  * Launch-time glue for auto-update.ts: decide what this interactive launch
  * does about an available update, what the SessionStart banner says now, and
  * when the background install starts (after Claude Code is up, never on the
- * startup path).
+ * startup path; on Windows only as ccc exits, see auto-update.ts).
  */
 import { AutoUpdateNotices, type AutoUpdateConfig, type AutoUpdateDecision, type InstallMethod, type SpawnLike, type StartInstallResult } from "./auto-update.js";
-import type { UpdateAvailable } from "./update-check.js";
+import { type UpdateAvailable } from "./update-check.js";
 export interface AutoUpdateSetupOptions {
     update: UpdateAvailable | null;
     currentVersion: string;
@@ -18,6 +18,12 @@ export interface AutoUpdateSetupOptions {
     spawnImpl?: SpawnLike;
     platform?: NodeJS.Platform;
     uid?: number;
+    /** process.argv[1], to see an `npm link` through the bin (detectInstallMethod). */
+    scriptPath?: string;
+    /** This process (Windows: the runner waits for it to exit). */
+    pid?: number;
+    /** Test-only: the Node (and so npm) the runner uses. */
+    execPath?: string;
 }
 export interface AutoUpdateSetup {
     decision: AutoUpdateDecision;
@@ -29,10 +35,20 @@ export interface AutoUpdateSetup {
     bannerInstalled: string | null;
     /** The SessionStart line for later hooks in this process (proxy option). */
     notices: AutoUpdateNotices;
-    /** Start the planned install after `delayMs`; a no-op unless planned. */
+    /**
+     * Start the planned install after `delayMs`; a no-op unless planned, and on
+     * Windows, where it starts in installOnExit instead.
+     */
     scheduleInstall(delayMs?: number, onResult?: (result: StartInstallResult) => void): void;
+    /**
+     * Windows: start the planned install now, as ccc exits; the runner waits for
+     * this process to be gone. A no-op elsewhere or unless planned.
+     */
+    installOnExit(onResult?: (result: StartInstallResult) => void): void;
     /** One line naming the install method and the decision, for --debug. */
     debugLine: string;
 }
+/** The banner's ending for a Windows update that installs as ccc exits. */
+export declare const WINDOWS_ON_EXIT_TEXT = "installs when you exit ccc";
 export declare function setupAutoUpdate(opts: AutoUpdateSetupOptions): AutoUpdateSetup;
 //# sourceMappingURL=auto-update-setup.d.ts.map

package/dist/auto-update-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-update-setup.d.ts","sourceRoot":"","sources":["../src/auto-update-setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,iBAAiB,EASjB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,uDAAuD;IACvD,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,uEAAuE;IACvE,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,+EAA+E;IAC/E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,4EAA4E;IAC5E,OAAO,EAAE,iBAAiB,CAAC;IAC3B,yEAAyE;IACzE,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI,CAAC;IACzF,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,eAAe,CA4C7E"}
+{"version":3,"file":"auto-update-setup.d.ts","sourceRoot":"","sources":["../src/auto-update-setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,iBAAiB,EAUjB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE1E,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,uDAAuD;IACvD,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,uEAAuE;IACvE,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,+EAA+E;IAC/E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,4EAA4E;IAC5E,OAAO,EAAE,iBAAiB,CAAC;IAC3B;;;OAGG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI,CAAC;IACzF;;;OAGG;IACH,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI,CAAC;IACrE,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,+BAA+B,CAAC;AAEjE,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,eAAe,CA8D7E"}

package/dist/auto-update-setup.js

@@ -2,11 +2,14 @@
  * Launch-time glue for auto-update.ts: decide what this interactive launch
  * does about an available update, what the SessionStart banner says now, and
  * when the background install starts (after Claude Code is up, never on the
- * startup path).
+ * startup path; on Windows only as ccc exits, see auto-update.ts).
  */
 import { spawn } from "node:child_process";
-import { AUTO_UPDATE_DELAY_MS, AutoUpdateNotices, PACKAGE_DIR, detectInstallMethod, liveLockSince, planAutoUpdate, readInstalledVersion, readUpdateState, startAutoUpdateInstall, updateFiles, } from "./auto-update.js";
+import { AUTO_UPDATE_DELAY_MS, AutoUpdateNotices, PACKAGE_DIR, detectInstallMethod, manualUpdateCommand, liveLockSince, planAutoUpdate, readInstalledVersion, readUpdateState, startAutoUpdateInstall, updateFiles, } from "./auto-update.js";
 import { updateInstalledNoticeText, updateNoticeText } from "./notices.js";
+import { UPGRADE_COMMAND } from "./update-check.js";
+/** The banner's ending for a Windows update that installs as ccc exits. */
+export const WINDOWS_ON_EXIT_TEXT = "installs when you exit ccc";
 export function setupAutoUpdate(opts) {
     const env = opts.env ?? process.env;
     const packageDir = opts.packageDir ?? PACKAGE_DIR;
@@ -24,34 +27,53 @@ export function setupAutoUpdate(opts) {
             installedVersion: readInstalledVersion(method.packageDir),
             lockHeldSince: liveLockSince(files.lockDir, now()),
         })
-        : { action: "skip", reason: "no update available" };
+        : { action: "skip", reason: "no update available", code: "no-update" };
+    const platform = opts.platform ?? process.platform;
+    const windows = platform === "win32";
+    const command = method ? manualUpdateCommand(method.kind) : undefined;
+    const withCommand = (update) => command && command !== UPGRADE_COMMAND ? { ...update, command } : update;
+    // Windows installs as ccc exits: say so now, since nothing installs during the session.
+    const onExitBanner = windows && decision.action === "install" && opts.update
+        ? { ...opts.update, command: WINDOWS_ON_EXIT_TEXT }
+        : null;
+    let started = false;
+    const start = (onResult) => {
+        if (decision.action !== "install" || started)
+            return;
+        started = true;
+        const spawnImpl = opts.spawnImpl ?? spawn;
+        const result = startAutoUpdateInstall({
+            decision, files, spawnImpl, env, now, platform, execPath: opts.execPath,
+            ...(windows ? { waitForPid: opts.pid ?? process.pid } : {}),
+        });
+        onResult?.(result);
+    };
     const notices = new AutoUpdateNotices({
         currentVersion: opts.currentVersion,
         packageDir: method?.packageDir ?? packageDir,
         stateFile: files.stateFile,
         startedAt: now(),
         installedText: (version) => updateInstalledNoticeText(version, opts.color),
-        hintText: (update) => updateNoticeText(update, opts.color),
+        hintText: (update) => updateNoticeText(withCommand(update), opts.color),
     });
     if (decision.action === "installed")
         notices.markShown();
     return {
         decision,
         method,
-        bannerUpdate: decision.action === "skip" ? opts.update : null,
+        bannerUpdate: decision.action === "skip" && opts.update ? withCommand(opts.update) : onExitBanner,
         bannerInstalled: decision.action === "installed" ? decision.version : null,
         notices,
         scheduleInstall(delayMs = AUTO_UPDATE_DELAY_MS, onResult) {
-            if (decision.action !== "install")
+            if (decision.action !== "install" || windows)
                 return;
-            const spawnImpl = opts.spawnImpl ?? spawn;
-            const timer = setTimeout(() => {
-                const result = startAutoUpdateInstall({ decision, files, spawnImpl, env, now });
-                onResult?.(result);
-            }, delayMs);
-            timer.unref();
+            setTimeout(() => start(onResult), delayMs).unref();
+        },
+        installOnExit(onResult) {
+            if (windows)
+                start(onResult);
         },
-        debugLine: debugLine(method, decision),
+        debugLine: debugLine(method, decision, windows),
     };
 }
 function detectMethod(opts, env, packageDir) {
@@ -60,13 +82,17 @@ function detectMethod(opts, env, packageDir) {
         env,
         platform: opts.platform,
         uid: opts.uid ?? process.getuid?.(),
+        scriptPath: opts.scriptPath,
     });
 }
-function debugLine(method, decision) {
+function debugLine(method, decision, windows) {
     const how = method ? `install method ${method.kind} (${method.detail})` : "no update to install";
-    const what = decision.action === "install" ? `installing ${decision.version} in the background`
+    const what = decision.action === "install"
+        ? (windows ? `installs ${decision.version} when ccc exits`
+            : `installing ${decision.version} in the background`)
         : decision.action === "installed" ? `${decision.version} already installed, restart to use it`
-            : `not installing: ${decision.reason}`;
+            : decision.code === "linked-install" ? "skipped: linked install"
+                : `not installing: ${decision.reason}`;
     return `Auto-update: ${how}; ${what}`;
 }
 //# sourceMappingURL=auto-update-setup.js.map

package/dist/auto-update-setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"auto-update-setup.js","sourceRoot":"","sources":["../src/auto-update-setup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"auto-update-setup.js","sourceRoot":"","sources":["../src/auto-update-setup.ts"],"names":[],"mappings":"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"}

package/dist/auto-update.d.ts

@@ -4,12 +4,22 @@
  * Code does ("✔ Update installed · Restart to update").
  *
  * Only when self-updating is safe: a plain global npm install whose package
- * directory is physically inside `<prefix>/lib/node_modules` and writable by
- * this user (no sudo, ever). npm-linked and git checkouts, npx and local
- * installs, pnpm/yarn/bun/volta globals, root/sudo runs and Windows get the
- * hint line only. The install runs in a detached runner (auto-update-runner.ts)
- * that loads no file from the package, so it survives this ccc exiting and
- * npm replacing the package under it.
+ * directory is physically inside `<prefix>/lib/node_modules` (on Windows
+ * `<prefix>\node_modules`) and writable by this user (no sudo, ever).
+ * npm-linked and git checkouts (detected through the bin link too, so an
+ * `npm link` is never replaced), npx and local installs, pnpm/yarn/bun/volta
+ * globals and root/sudo runs get the hint line only, with the command that
+ * fits how they were installed. The install runs in a detached runner
+ * (auto-update-runner.ts) that loads no file from the package, so it survives
+ * this ccc exiting and npm replacing the package under it.
+ *
+ * Windows: the runner starts only as ccc exits (also when the window is
+ * closed) and waits for this process to be gone before npm runs, so npm does
+ * not rewrite files under the session that started it (other running
+ * sessions are as on POSIX: they already loaded their code; the shim npm
+ * rewrites is identical between versions). npm is run as `node npm-cli.js` (no
+ * shell: Node refuses to spawn a .cmd without one), and the runner kills
+ * npm's process tree with taskkill instead of a POSIX process group.
  *
  * One install at a time across sessions (a lock file with a stale timeout).
  * Every attempt is recorded in update-state.json: a failure backs off for a
@@ -60,12 +70,17 @@ export interface UpdateAttempt {
     at: number;
     packageDir: string;
     error?: string;
+    /** A launch has sent this result to diagnostics (takeUnreportedOutcome). */
+    reported?: boolean;
 }
 export interface UpdateState {
     /** Install attempts per version (newest few kept). */
     attempts: Record<string, number>;
     last?: UpdateAttempt;
 }
+/** Why a launch with an update available did not install it, for diagnostics. */
+export declare const SKIP_CODES: readonly ["disabled", "not-release", "linked-install", "install-method", "backoff", "max-attempts", "lock-held"];
+export type SkipCode = (typeof SKIP_CODES)[number] | "no-update";
 export type AutoUpdateDecision = {
     action: "install";
     version: string;
@@ -76,9 +91,21 @@ export type AutoUpdateDecision = {
 } | {
     action: "skip";
     reason: string;
+    code: SkipCode;
 };
 export interface DetectInstallOptions {
     packageDir: string;
+    /**
+     * The script as started (process.argv[1]), before symlinks are resolved:
+     * through it an `npm link` shows even though Node reports the checkout as
+     * the package directory.
+     */
+    scriptPath?: string;
+    /**
+     * Windows: test writability by creating a file (default true). Diagnostics
+     * pass false, so a launch with no update writes nothing into the package.
+     */
+    probeWrites?: boolean;
     platform?: NodeJS.Platform;
     /** process.getuid(); undefined where there is none. */
     uid?: number;
@@ -105,6 +132,7 @@ export type SpawnLike = (command: string, args: string[], options: {
     detached: boolean;
     stdio: "ignore";
     env: NodeJS.ProcessEnv;
+    windowsHide: boolean;
 }) => {
     pid?: number;
     unref(): void;
@@ -119,6 +147,11 @@ export interface StartInstallOptions {
     execPath?: string;
     /** The npm to run; default the one beside this Node, else `npm` on PATH. */
     npmPath?: string;
+    /** Arguments before npm's own (Windows: npm-cli.js, run by this Node). */
+    npmArgs?: string[];
+    platform?: NodeJS.Platform;
+    /** Windows: the ccc whose exit the runner waits for before installing. */
+    waitForPid?: number;
 }
 export type StartInstallResult = "started" | "locked" | "not-planned" | "spawn-failed"
 /** Rechecked under the lock: backed off, tried enough, or already installed. */
@@ -132,6 +165,14 @@ export declare function strictReleaseVersion(version: unknown): string | null;
  * runner re-checks the root against `npm root -g` before installing.
  */
 export declare function detectInstallMethod(opts: DetectInstallOptions): InstallMethod;
+/** True for the installs whose files are the user's own checkout. */
+export declare function isLinkedInstall(kind: InstallMethodKind): boolean;
+/**
+ * How to update this install by hand: never `npm i -g` over a linked checkout
+ * (that replaces the link with the published package), and each package
+ * manager's own command for its globals.
+ */
+export declare function manualUpdateCommand(kind: InstallMethodKind): string;
 /** Decide what this launch does about an available update. */
 export declare function planAutoUpdate(opts: PlanOptions): AutoUpdateDecision;
 /**
@@ -161,10 +202,22 @@ export declare class AutoUpdateNotices {
     sessionStartLine(): string | undefined;
     private pendingLine;
 }
+/**
+ * The result of the last background install, once: "ok" or "failed" the
+ * first time a launch sees it finished, then null (marked reported in the
+ * state file). For diagnostics, which the detached runner cannot send.
+ */
+export declare function takeUnreportedOutcome(stateFile: string, lockDir?: string, now?: number): "ok" | "failed" | null;
 /** The version in `<packageDir>/package.json`, or null. */
 export declare function readInstalledVersion(packageDir: string): string | null;
 export declare function updateFiles(configDir: string): UpdateFiles;
 export declare function readUpdateState(file: string): UpdateState;
 /** Best effort and atomic: a failed write only loses bookkeeping. */
 export declare function writeUpdateState(file: string, state: UpdateState): void;
+/**
+ * The `node_modules/claude-code-infinite` entry the script was started
+ * through, when that entry is a symlink or junction (an `npm link`). The bin
+ * itself may be a symlink (POSIX `<prefix>/bin/ccc`): one hop is followed.
+ */
+export declare function linkedPackageEntry(scriptPath: string): string | null;
 //# sourceMappingURL=auto-update.d.ts.map