relmio 0.2.8 → 0.2.9

package/CHANGELOG.md

@@ -7,6 +7,17 @@ checks the registry separately after publication.
 
 ## Unreleased
 
+## [0.2.9] - 2026-08-02
+
+### Fixed
+
+- Launch the local ChatGPT OAuth helper through the current Windows Node.js
+  runtime and npm's JavaScript CLI instead of executing `npx.cmd` directly,
+  preventing `spawn EINVAL` while preserving the native `npx` path on macOS,
+  Linux, WSL, and Git Bash.
+- Explain how to recover when a refreshed wizard page no longer has its private
+  session URL.
+
 ## [0.2.8] - 2026-08-02
 
 ### Changed

package/README.md

@@ -124,6 +124,10 @@ Users who already have Node.js 22 or newer can run the npm package directly:
 npx --yes --ignore-scripts relmio@latest
 ```
 
+Keep the active setup terminal open while using the wizard. If the page says
+the wizard link is incomplete, close that tab and open the full `Local wizard:`
+URL printed by the current terminal instead of refreshing the stripped page.
+
 ### Requirements
 
 - On macOS/Linux/WSL/Git Bash: `curl`, `awk`, `tar`, and either `sha256sum` or

package/docs/troubleshooting.md

@@ -113,7 +113,9 @@ bypassed.
 | `node: command not found`, `node is not recognized`, or Node is older than 22 | The NPX fallback cannot use the local runtime. | Use the macOS/Linux curl command or the native Windows PowerShell/Command Prompt command above. Either can run with a verified temporary runtime. Do not install Node.js on the VPS for the wizard. |
 | `curl` or `sh` is not recognized on Windows | The macOS/Linux command was pasted into a native Windows terminal. | Use the PowerShell command in PowerShell, or the longer `powershell -NoProfile ...` command in Command Prompt. Git Bash is not required. |
 | A bootstrap reports a checksum mismatch | The Node.js download did not match the official SHA-256 manifest, so it was not executed. | Retry on a trusted connection. Do not bypass the check. If it repeats, use an existing Node.js 22+ installation and report the sanitized error. |
+| Windows reports `spawn EINVAL` when starting ChatGPT sign-in | An older wizard tried to execute `npx.cmd` directly; Windows requires the current Node runtime to launch npm's JavaScript CLI. | Update to the latest `relmio@latest` release and restart the setup command. The current wizard keeps the macOS/Linux/WSL/Git Bash `npx` path unchanged. |
 | The browser did not open | The automatic browser launch failed, but the local server may still be running. | Keep the newest terminal open and copy its newest `127.0.0.1` setup URL into the browser. Do not reuse a URL from a closed terminal. |
+| The wizard says `This wizard link is incomplete` | The page was refreshed or opened without the private `?session=...` token; the token is removed from the address bar after startup. | Close the tab and open the complete `Local wizard:` URL printed by the active setup terminal. Do not reuse a URL from a closed terminal. |
 | An old wizard page reports an invalid or expired setup session | The local server was closed or a newer wizard run created a different one-time session token. | Close the old page and use only the URL printed by the currently running terminal. |
 | `npx` appears to run an older wizard | An old terminal or tab is still active, or the package was run without an explicit tag. | Close old runs, check `npm view relmio version`, then run `npx --yes --ignore-scripts relmio@latest`. |
 | `This sign-in request expired` | The OAuth tab is old or the five-minute callback window ended. | Close the old tab and select **Refresh ChatGPT sign-in** from the newest active wizard. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relmio",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Turn a supported ChatGPT/Codex OAuth sign-in into a private OpenAI-compatible endpoint, starting with self-hosted n8n.",
   "keywords": [
     "relmio",

package/src/services/oauth.js

@@ -16,6 +16,37 @@ const OPENAI_AUTH_ORIGIN = "https://auth.openai.com";
 const wait = (milliseconds) =>
   new Promise((resolvePromise) => setTimeout(resolvePromise, milliseconds));
 
+function resolveWindowsNpxCli({ env, execPath }) {
+  const npmExecPathKey = Object.keys(env ?? {}).find(
+    (key) => key.toLowerCase() === "npm_execpath",
+  );
+  const npmExecPath =
+    npmExecPathKey === undefined ? undefined : env[npmExecPathKey];
+
+  if (typeof npmExecPath === "string") {
+    if (/(?:^|[\\/])npx-cli\.js$/iu.test(npmExecPath)) {
+      return resolve(npmExecPath);
+    }
+    if (/(?:^|[\\/])npm-cli\.js$/iu.test(npmExecPath)) {
+      return resolve(dirname(npmExecPath), "npx-cli.js");
+    }
+  }
+
+  return resolve(dirname(execPath), "node_modules", "npm", "bin", "npx-cli.js");
+}
+
+function createNpxInvocation({ platform, env, execPath }) {
+  if (platform !== "win32") {
+    return { command: "npx", prefixArgs: [] };
+  }
+
+  return {
+    command: execPath,
+    // Windows cannot execute npx.cmd directly with shell:false.
+    prefixArgs: [resolveWindowsNpxCli({ env, execPath })],
+  };
+}
+
 export function resolveAuthPath({
   env = process.env,
   homeDirectory = homedir(),
@@ -132,11 +163,12 @@ export async function startOAuthLogin({
   env = process.env,
   homeDirectory = homedir(),
   platform = process.platform,
+  execPath = process.execPath,
   spawnProcess = spawn,
   createPendingId = randomUUID,
   waitForCredentialPoll = wait,
 } = {}) {
-  const command = platform === "win32" ? "npx.cmd" : "npx";
+  const npxInvocation = createNpxInvocation({ platform, env, execPath });
   const authPath = resolveAuthPath({ env, homeDirectory });
   const authDirectory = dirname(authPath);
   const pendingAuthPath = `${authPath}.pending-${createPendingId()}`;
@@ -155,12 +187,24 @@ export async function startOAuthLogin({
   await fileSystem.mkdir(authDirectory, { recursive: true, mode: 0o700 });
   await fileSystem.chmod(authDirectory, 0o700);
 
-  const child = spawnProcess(command, args, {
-    env,
-    shell: false,
-    stdio: ["ignore", "pipe", "pipe"],
-    windowsHide: true,
-  });
+  let child;
+  try {
+    child = spawnProcess(
+      npxInvocation.command,
+      [...npxInvocation.prefixArgs, ...args],
+      {
+        env,
+        shell: false,
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true,
+      },
+    );
+  } catch (error) {
+    throw new Error(
+      "The local sign-in command could not start. Update Relmio and retry with Node.js 22 or newer.",
+      { cause: error },
+    );
+  }
   child.stderr?.resume();
 
   let loginOutput = "";

package/src/ui/app.js

@@ -146,7 +146,9 @@ function showStep(step) {
 
 async function api(path, { method = "GET", body } = {}) {
   if (!token) {
-    throw new Error("This wizard link is incomplete. Restart the setup command.");
+    throw new Error(
+      "This wizard link is incomplete. Close this tab and open the full URL printed by the active setup terminal.",
+    );
   }
 
   let response;