termexo 0.3.2 → 0.3.3

package/README.md

@@ -1,6 +1,6 @@
 # Termexo npm launcher
 
-This package is the official Windows launcher for
+This package runs the official Windows desktop executable for
 [Termexo](https://www.termexo.com/), a local-first workspace for AI coding
 agents, models, and terminals.
 
@@ -13,25 +13,25 @@ npm install --global termexo
 termexo
 ```
 
-The npm package contains the launcher, not the desktop application. Install the
-latest Termexo desktop release first:
+The Windows desktop executable is included in the npm package, so no separate
+Termexo installation is required. You can also run it without a global install:
 
 ```powershell
-termexo download
+npx termexo
 ```
 
 ## Commands
 
 ```text
-termexo              Start Termexo
-termexo start        Start Termexo
+termexo              Start the bundled Termexo desktop app
+termexo start        Start the bundled Termexo desktop app
 termexo download     Open the latest release page
 termexo --version    Show the launcher version
 termexo --help       Show command help
 ```
 
-If Termexo is installed in a custom directory, set `TERMEXO_PATH` to the full
-path of `termexo.exe`.
+Set `TERMEXO_PATH` to the full path of another `termexo.exe` to override the
+bundled executable.
 
 Project source and desktop releases are available at
 [github.com/gemron/Termexo](https://github.com/gemron/Termexo).

package/bin/termexo.js

@@ -17,8 +17,8 @@ function printHelp() {
   console.log(`Termexo ${packageJson.version}
 
 Usage:
-  termexo              Start the installed Termexo desktop app
-  termexo start        Start the installed Termexo desktop app
+  termexo              Start the bundled Termexo desktop app
+  termexo start        Start the bundled Termexo desktop app
   termexo download     Open the latest Termexo release page
   termexo --version    Print the launcher version
   termexo --help       Show this help
@@ -37,9 +37,10 @@ if (command === '--help' || command === '-h' || command === 'help') {
 } else if (command === 'start') {
   const executable = findExecutable();
   if (!executable) {
-    console.error(`Termexo is not installed in a standard location.
+    console.error(`The Termexo executable is missing from this npm package.
 
-Download the Windows installer:
+Reinstall the package or download the Windows installer:
+  npm install --global termexo@latest
   termexo download
   ${RELEASES_URL}
 

package/lib/launcher.js

@@ -1,10 +1,17 @@
 import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { win32 } from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 export const RELEASES_URL = 'https://github.com/gemron/Termexo/releases/latest';
+export const BUNDLED_EXECUTABLE = fileURLToPath(
+  new URL('../vendor/win32-x64/termexo.exe', import.meta.url),
+);
 
-export function executableCandidates(environment = process.env) {
+export function executableCandidates(
+  environment = process.env,
+  bundledExecutable = BUNDLED_EXECUTABLE,
+) {
   const candidates = [];
   const add = (value) => {
     if (value && !candidates.includes(value)) {
@@ -13,6 +20,7 @@ export function executableCandidates(environment = process.env) {
   };
 
   add(environment.TERMEXO_PATH);
+  add(bundledExecutable);
 
   if (environment.LOCALAPPDATA) {
     add(win32.join(environment.LOCALAPPDATA, 'Termexo', 'termexo.exe'));
@@ -30,8 +38,14 @@ export function executableCandidates(environment = process.env) {
   return candidates;
 }
 
-export function findExecutable(environment = process.env, fileExists = existsSync) {
-  return executableCandidates(environment).find((candidate) => fileExists(candidate));
+export function findExecutable(
+  environment = process.env,
+  fileExists = existsSync,
+  bundledExecutable = BUNDLED_EXECUTABLE,
+) {
+  return executableCandidates(environment, bundledExecutable).find((candidate) =>
+    fileExists(candidate),
+  );
 }
 
 export function launchExecutable(executable, spawnProcess = spawn) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "termexo",
-  "version": "0.3.2",
-  "description": "Official Windows launcher for the Termexo AI development workspace",
+  "version": "0.3.3",
+  "description": "Run the Termexo AI development workspace directly from npm on Windows",
   "type": "module",
   "bin": {
     "termexo": "bin/termexo.js"
@@ -9,6 +9,7 @@
   "files": [
     "bin/",
     "lib/",
+    "vendor/win32-x64/termexo.exe",
     "README.md"
   ],
   "os": [
@@ -19,6 +20,7 @@
   },
   "scripts": {
     "test": "node --test",
+    "prepack": "node scripts/stage-binary.mjs",
     "prepublishOnly": "npm test"
   },
   "keywords": [