nomadexapp 0.1.0 → 0.2.0

package/README.md

@@ -83,6 +83,22 @@ The packaged launcher:
 6. prints a UI password and requires it before the browser can open the workspace
 7. checks whether a newer npm release is available and prompts before startup when appropriate
 
+### 📱 Termux
+
+Nomadex also works on Termux.
+
+Recommended Codex install on Termux:
+
+```bash
+npm install -g @mmmbuto/codex-cli-termux@latest
+```
+
+The launcher now prefers the host `codex` binary on Termux instead of forcing the bundled desktop `@openai/codex` dependency. If your Codex binary lives in a non-standard location, launch with:
+
+```bash
+NOMADEX_CODEX_CMD=/data/data/com.termux/files/usr/bin/codex npx nomadexapp
+```
+
 Open:
 
 - 🏠 Local machine: `http://127.0.0.1:3784`
@@ -168,10 +184,10 @@ More detail: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
 - [x] Theme picker, settings, skills library, and account/provider surfaces
 - [x] Local workspace browsing and uploaded asset handling
 - [x] Provider-aware launcher and app layer
+- [x] First public npm release of `nomadexapp`
 
 ### 🧭 Next
 
-- [ ] Publish the first public npm release
 - [ ] Harden the packaged launcher for more providers and remote auth flows
 - [ ] Extend provider parity beyond the current Codex-first runtime path
 - [ ] Improve durable cross-provider thread memory and reload persistence
@@ -186,6 +202,7 @@ More detail: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
 ## 🚢 Publishing
 
 - `main` now has GitHub Actions for lint, build, and npm publish.
+- successful npm publishes also create a matching GitHub Release
 - The publish workflow only releases when the version in `package.json` is not already on npm.
 - Add a repo secret named `NPM_TOKEN` before relying on automatic publish.
 - To ship an update, bump the package version, push to `main`, and GitHub Actions will publish `nomadexapp` automatically.

package/bin/nomadex.mjs

@@ -59,6 +59,7 @@ const parseArgs = (argv) => {
       process.env.NOMADEX_AUTH_RELAY_TARGET ??
       process.env.VITE_CODEX_AUTH_RELAY_TARGET ??
       "http://127.0.0.1:1455",
+    codexCommand: process.env.NOMADEX_CODEX_CMD ?? "",
     password: process.env.NOMADEX_PASSWORD ?? "",
     updateCheck:
       process.env.NOMADEX_NO_UPDATE_CHECK === "1" ? false : true,
@@ -94,6 +95,11 @@ const parseArgs = (argv) => {
       index += 1;
       continue;
     }
+    if (arg === "--codex-cmd") {
+      options.codexCommand = argv[index + 1] ?? options.codexCommand;
+      index += 1;
+      continue;
+    }
     if (arg === "--password") {
       options.password = argv[index + 1] ?? options.password;
       index += 1;
@@ -124,6 +130,7 @@ Options:
   --port <port>                UI port (default: 3784)
   --ws-url <url>               App-server websocket target (default: ws://127.0.0.1:3901)
   --auth-relay-target <url>    Auth relay HTTP target (default: http://127.0.0.1:1455)
+  --codex-cmd <path>           Codex CLI command or absolute path override
   --password <value>           UI password (default: generated per launch)
   --no-update-check            Skip npm registry update prompt
   --help                       Show this help
@@ -428,6 +435,13 @@ const readyzUrl = (() => {
   return target;
 })();
 const authRelayTarget = options.authRelayTarget;
+const isTermuxEnvironment = () => {
+  const prefix = process.env.PREFIX ?? "";
+  return (
+    Boolean(process.env.TERMUX_VERSION) ||
+    prefix.startsWith("/data/data/com.termux/files/usr")
+  );
+};
 
 const resolveLocalNodePackageLaunch = (packageName, binName) => {
   try {
@@ -453,13 +467,73 @@ const resolveLocalNodePackageLaunch = (packageName, binName) => {
   }
 };
 
-const getCodexLaunch = () =>
-  resolveLocalNodePackageLaunch("@openai/codex", "codex") ?? {
+const resolveExecutableOnPath = (commandNames) => {
+  const pathDirs = (process.env.PATH ?? "").split(path.delimiter).filter(Boolean);
+
+  for (const dir of pathDirs) {
+    for (const commandName of commandNames) {
+      const candidate = path.join(dir, commandName);
+      try {
+        if (statSync(candidate).isFile()) {
+          return candidate;
+        }
+      } catch {
+        continue;
+      }
+    }
+  }
+
+  return null;
+};
+
+const resolvePathCodexLaunch = () => {
+  const commandNames =
+    process.platform === "win32"
+      ? ["codex.cmd", "codex.exe", "codex.bat", "codex"]
+      : ["codex"];
+  const command = resolveExecutableOnPath(commandNames);
+  if (!command) {
+    return null;
+  }
+
+  return {
+    command,
+    args: [],
+    shell: false,
+    source: "PATH codex",
+  };
+};
+
+const getCodexLaunch = () => {
+  const explicitCommand = options.codexCommand.trim();
+  if (explicitCommand) {
+    return {
+      command: explicitCommand,
+      args: [],
+      shell: false,
+      source: "--codex-cmd / NOMADEX_CODEX_CMD",
+    };
+  }
+
+  const dependencyLaunch = resolveLocalNodePackageLaunch("@openai/codex", "codex");
+  const pathLaunch = resolvePathCodexLaunch();
+
+  if (isTermuxEnvironment()) {
+    return pathLaunch ?? dependencyLaunch ?? {
+      command: process.platform === "win32" ? "codex.cmd" : "codex",
+      args: [],
+      shell: false,
+      source: "global PATH",
+    };
+  }
+
+  return dependencyLaunch ?? pathLaunch ?? {
     command: process.platform === "win32" ? "codex.cmd" : "codex",
     args: [],
     shell: false,
     source: "global PATH",
   };
+};
 
 const isPortOpen = (targetHost, targetPort) =>
   new Promise((resolve) => {
@@ -508,6 +582,9 @@ const formatSpawnError = (error) => {
     "code" in error &&
     error.code === "ENOENT"
   ) {
+    if (isTermuxEnvironment()) {
+      return "Could not find a working Codex CLI. On Termux, install `@mmmbuto/codex-cli-termux@latest`, make sure `codex` is on PATH, or set `NOMADEX_CODEX_CMD`.";
+    }
     return "Could not find the Codex CLI. Install `@openai/codex` or use the bundled package dependency.";
   }
 
@@ -583,8 +660,12 @@ const ensureAppServer = async () => {
       return;
     }
     if (appServer.exitCode !== null) {
+      const termuxHint =
+        isTermuxEnvironment() && codexLaunch.source !== "PATH codex"
+          ? " Termux detected. Install `@mmmbuto/codex-cli-termux@latest`, ensure `codex` is on PATH, or launch Nomadex with `--codex-cmd codex`."
+          : "";
       throw new Error(
-        `Codex app-server exited with code ${appServer.exitCode} (${codexLaunch.source}).`,
+        `Codex app-server exited with code ${appServer.exitCode} (${codexLaunch.source}).${termuxHint}`,
       );
     }
     await sleep(200);

package/docs/SETUP.md

@@ -18,6 +18,16 @@ Quick check:
 codex --version
 ```
 
+### Termux
+
+Recommended Codex install on Termux:
+
+```bash
+npm install -g @mmmbuto/codex-cli-termux@latest
+```
+
+Nomadex now prefers the host `codex` binary on Termux, so it does not need to rely on the bundled desktop `@openai/codex` package there.
+
 ## 2. Recommended Launch
 
 Normal use:
@@ -116,6 +126,8 @@ Main variables:
   UI port used by `npx nomadexapp`. Default: `3784`
 - `NOMADEX_AUTH_RELAY_TARGET`
   HTTP target used by the packaged auth relay. Default: `http://127.0.0.1:1455`
+- `NOMADEX_CODEX_CMD`
+  Codex CLI command or full path override for the packaged launcher. Useful on Termux or custom installs.
 - `NOMADEX_PASSWORD`
   Stable UI password for the packaged launcher. If unset, Nomadex generates one on each launch and prints it in the terminal.
 - `VITE_CODEX_WS_URL`
@@ -130,6 +142,7 @@ Examples:
 ```bash
 npx nomadexapp --port 4173
 npx nomadexapp --ws-url ws://127.0.0.1:3902
+NOMADEX_CODEX_CMD=/data/data/com.termux/files/usr/bin/codex npx nomadexapp
 NOMADEX_PASSWORD=my-secret npx nomadexapp
 VITE_CODEX_UI_PORT=4173 npm run dev:live
 VITE_CODEX_WS_URL=ws://127.0.0.1:3902 npm run dev:live
@@ -163,6 +176,7 @@ Behavior:
 - pushes and pull requests run `npm ci`, `npm run lint`, and `npm run build`
 - pushes to `main` also check npm
 - if the current `package.json` version is not published yet, GitHub Actions runs `npm publish --access public --provenance`
+- successful npm publishes also create a matching GitHub Release tag like `v0.1.0`
 
 Required setup:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nomadexapp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Remote browser workspace for local coding agents",
   "license": "MIT",
   "type": "module",