@bitkyc08/opencodex 2.7.26 → 2.7.27-preview.20260720

package/README.md

@@ -62,7 +62,7 @@ flowchart LR
 |---|---|---|
 | macOS (arm64 / x64) | Fully supported | launchd |
 | Linux (x64 / arm64) | Fully supported | systemd (user unit) |
-| Windows (x64) | Fully supported | Task Scheduler |
+| Windows (x64) | Fully supported | Task Scheduler (hidden) / opt-in native service (`--native`, WinSW) |
 
 Requires [Node](https://nodejs.org) 18+. The Bun runtime is bundled automatically on `npm install` — no separate Bun install needed. All three platforms work natively (no WSL needed on Windows).
 
@@ -234,7 +234,7 @@ next Codex session. opencodex keeps these behaviors:
 - **Give any model superpowers.** Non-OpenAI models get real web search and image understanding via a `gpt-5.4-mini` sidecar over your ChatGPT login.
 - **Generate images natively.** Codex's standalone `image_gen` tool uses `POST /v1/images/generations` for generation and `POST /v1/images/edits` for edits; it is separate from the hosted Responses `image_generation` tool.
 - **See what's happening.** The web dashboard shows providers, OAuth status, model selection, and a live request log, including cached/cache-write token counts when upstream reports them — no more guessing why a request failed.
-- **Runs in the background.** Install as a system service (launchd / systemd / Task Scheduler) and forget about it. The proxy starts on boot and stays out of your way.
+- **Runs in the background.** Install as a system service (launchd / systemd / Task Scheduler) and forget about it. On macOS/Linux the proxy starts at login; on Windows the default Task Scheduler backend starts at logon (windowless), or use `ocx service install --native` for a real Windows service that starts at boot.
 - **Clean exit, zero residue.** `ocx stop` (or the dashboard's Stop button) shuts down the proxy, stops the background service if one is installed, and restores Codex to its original configuration. Plain `codex` works exactly as it did before — no leftover config, no orphaned processes.
 
 ## Providers & adapters

package/bin/ocx.mjs

@@ -113,7 +113,16 @@ function runNpmSelfUpdate() {
 
   // Remember whether a background service manages the proxy BEFORE stopping — `ocx stop`
   // unloads it permanently, so a successful update must reinstall it afterwards.
-  const serviceWasInstalled = existsSync(join(configDir(), "service-state.json"));
+  const serviceStatePath = join(configDir(), "service-state.json");
+  const serviceWasInstalled = existsSync(serviceStatePath);
+  /** Read the backend from service-state.json so the update reinstalls the same one. */
+  function serviceReinstallArgs() {
+    try {
+      const state = JSON.parse(readFileSync(serviceStatePath, "utf8"));
+      if (state.backend === "native") return [launcher, "service", "install", "--native"];
+    } catch { /* missing or corrupt — fall through to default */ }
+    return [launcher, "service", "install"];
+  }
 
   // Never replace package files under a live proxy — stop it first (full `ocx stop`
   // semantics: graceful drain, service stop, native Codex restore). Gate on the service
@@ -154,7 +163,8 @@ function runNpmSelfUpdate() {
     // launcher so the new files write the baked paths and the service restarts.
     if (serviceWasInstalled) {
       console.log("Reinstalling the background service with the updated files...");
-      const svc = spawnSync(process.execPath, [launcher, "service", "install"], { stdio: "inherit", windowsHide: true });
+      const svcArgs = serviceReinstallArgs();
+      const svc = spawnSync(process.execPath, svcArgs, { stdio: "inherit", windowsHide: true });
       if (svc.status !== 0) console.warn("opencodex: service refresh failed — run 'ocx service install' manually.");
     } else {
       console.log("Restart the proxy:  ocx start");
@@ -222,6 +232,17 @@ function resolveBun() {
   return bin;
 }
 
+// `ocx update --help` prints usage and exits WITHOUT side effects. The npm launcher
+// intercepts `update` before the Bun CLI starts, so the help short-circuit must live
+// here too — otherwise --help runs the real self-update, stops the proxy, and drops
+// in-flight routed streams (issue #168).
+const updateHelpRequested = process.argv[2] === "update" &&
+  process.argv.slice(3).some(a => a === "--help" || a === "-h" || a === "help");
+if (updateHelpRequested) {
+  console.log("Usage: ocx update [--tag latest|preview]\n\nUpdate opencodex. Preview installs stay on the preview tag unless overridden.");
+  process.exit(0);
+}
+
 if (process.argv[2] === "update" && isNodeModulesInstall() && !isBunGlobalInstall()) {
   runNpmSelfUpdate();
 }