relmio 0.2.7 → 0.2.9

package/CHANGELOG.md

@@ -7,6 +7,27 @@ 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
+
+- Replace the local browser wizard's text appearance selector with compact,
+  accessible System/Light/Dark icons, while keeping the original horizontal
+  Signal Spine flow and touch-friendly behavior.
+- Serve the bundled Lucide SVG assets from the wizard and include them in the
+  npm package so offline and Node-free browser launches render consistently.
+
 ## [0.2.7] - 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.7",
+  "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;

package/src/ui/icons/monitor.svg

@@ -0,0 +1,6 @@
+<!-- Lucide monitor icon, ISC licensed: https://lucide.dev/license -->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">
+  <rect width="20" height="14" x="2" y="3" rx="2" />
+  <line x1="8" x2="16" y1="21" y2="21" />
+  <line x1="12" x2="12" y1="17" y2="21" />
+</svg>

package/src/ui/icons/moon.svg

@@ -0,0 +1,4 @@
+<!-- Lucide moon icon, ISC licensed: https://lucide.dev/license -->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M20.985 12.486a9 9 0 1 1-9.473-9.472c.405-.022.617.46.402.803a6 6 0 0 0 8.268 8.268c.344-.215.825-.004.803.401" />
+</svg>

package/src/ui/icons/sun.svg

@@ -0,0 +1,12 @@
+<!-- Lucide sun icon, ISC licensed: https://lucide.dev/license -->
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">
+  <circle cx="12" cy="12" r="4" />
+  <path d="M12 2v2" />
+  <path d="M12 20v2" />
+  <path d="m4.93 4.93 1.41 1.41" />
+  <path d="m17.66 17.66 1.41 1.41" />
+  <path d="M2 12h2" />
+  <path d="M20 12h2" />
+  <path d="m6.34 17.66-1.41 1.41" />
+  <path d="m19.07 4.93-1.41 1.41" />
+</svg>

package/src/ui/index.html

@@ -35,17 +35,20 @@
       <div class="header-actions">
         <fieldset class="theme-picker">
           <legend class="visually-hidden">Color theme</legend>
-          <label>
+          <label title="Use system appearance">
             <input type="radio" name="color-theme" value="system" checked />
-            <span>System</span>
+            <span class="theme-icon theme-icon-system" aria-hidden="true"></span>
+            <span class="visually-hidden">System</span>
           </label>
-          <label>
+          <label title="Use light appearance">
             <input type="radio" name="color-theme" value="light" />
-            <span>Light</span>
+            <span class="theme-icon theme-icon-light" aria-hidden="true"></span>
+            <span class="visually-hidden">Light</span>
           </label>
-          <label>
+          <label title="Use dark appearance">
             <input type="radio" name="color-theme" value="dark" />
-            <span>Dark</span>
+            <span class="theme-icon theme-icon-dark" aria-hidden="true"></span>
+            <span class="visually-hidden">Dark</span>
           </label>
         </fieldset>
         <span class="local-badge">Runs only on this computer</span>

package/src/ui/styles.css

@@ -201,9 +201,9 @@ a:focus-visible {
   min-width: 0;
   margin: 0;
   padding: 0.1875rem;
-  border: 1px solid var(--border);
-  border-radius: 0.625rem;
-  background: var(--surface-muted);
+  border: 0;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--text) 88%, var(--border));
 }
 
 .theme-picker label {
@@ -217,29 +217,50 @@ a:focus-visible {
   pointer-events: none;
 }
 
-.theme-picker span {
-  min-height: 2rem;
+.theme-picker .theme-icon {
+  width: 1.75rem;
+  min-height: 1.75rem;
   display: inline-flex;
   align-items: center;
   justify-content: center;
-  padding: 0 0.625rem;
-  border-radius: 0.4375rem;
-  color: var(--text-muted);
-  font-size: 0.6875rem;
-  font-weight: 700;
+  padding: 0;
+  border-radius: 999px;
+  color: rgb(255 255 255 / 72%);
   transition:
     color 160ms var(--ease),
     background 160ms var(--ease),
     box-shadow 160ms var(--ease);
 }
 
-.theme-picker input:checked + span {
+.theme-picker .theme-icon::before {
+  width: 1rem;
+  height: 1rem;
+  content: "";
+  display: block;
+  background: currentColor;
+  mask: center / contain no-repeat var(--theme-icon);
+  -webkit-mask: center / contain no-repeat var(--theme-icon);
+}
+
+.theme-icon-system {
+  --theme-icon: url("/icons/monitor.svg");
+}
+
+.theme-icon-light {
+  --theme-icon: url("/icons/sun.svg");
+}
+
+.theme-icon-dark {
+  --theme-icon: url("/icons/moon.svg");
+}
+
+.theme-picker input:checked + .theme-icon {
   color: var(--text);
   background: var(--surface);
   box-shadow: var(--shadow-sm);
 }
 
-.theme-picker input:focus-visible + span {
+.theme-picker input:focus-visible + .theme-icon {
   outline: 3px solid #f2a94a;
   outline-offset: 2px;
 }
@@ -1050,10 +1071,6 @@ footer p {
     gap: 0.375rem;
   }
 
-  .theme-picker span {
-    padding-inline: 0.5rem;
-  }
-
   .shell {
     width: min(100% - 1rem, 54rem);
     padding-top: 2rem;

package/src/web/server.js

@@ -182,6 +182,9 @@ async function loadDefaultUiFiles() {
     readFile(new URL("../ui/theme.js", import.meta.url), "utf8"),
     readFile(new URL("../ui/time.js", import.meta.url), "utf8"),
     readFile(new URL("../ui/styles.css", import.meta.url), "utf8"),
+    readFile(new URL("../ui/icons/monitor.svg", import.meta.url), "utf8"),
+    readFile(new URL("../ui/icons/sun.svg", import.meta.url), "utf8"),
+    readFile(new URL("../ui/icons/moon.svg", import.meta.url), "utf8"),
   ]);
 
   return {
@@ -190,6 +193,9 @@ async function loadDefaultUiFiles() {
     "/theme.js": files[2],
     "/time.js": files[3],
     "/styles.css": files[4],
+    "/icons/monitor.svg": files[5],
+    "/icons/sun.svg": files[6],
+    "/icons/moon.svg": files[7],
   };
 }
 
@@ -421,9 +427,11 @@ function createRequestHandler(state) {
       const contentType =
         path.endsWith(".js")
           ? "text/javascript; charset=utf-8"
-          : path === "/styles.css"
-            ? "text/css; charset=utf-8"
-            : "text/html; charset=utf-8";
+          : path.endsWith(".svg")
+            ? "image/svg+xml; charset=utf-8"
+            : path === "/styles.css"
+              ? "text/css; charset=utf-8"
+              : "text/html; charset=utf-8";
       const contents = state.uiFiles[path];
       response.writeHead(200, {
         "Content-Type": contentType,