termexo 0.3.2

package/README.md

@@ -0,0 +1,37 @@
+# Termexo npm launcher
+
+This package is the official Windows launcher for
+[Termexo](https://www.termexo.com/), a local-first workspace for AI coding
+agents, models, and terminals.
+
+## Install
+
+Termexo currently supports Windows.
+
+```powershell
+npm install --global termexo
+termexo
+```
+
+The npm package contains the launcher, not the desktop application. Install the
+latest Termexo desktop release first:
+
+```powershell
+termexo download
+```
+
+## Commands
+
+```text
+termexo              Start Termexo
+termexo start        Start Termexo
+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`.
+
+Project source and desktop releases are available at
+[github.com/gemron/Termexo](https://github.com/gemron/Termexo).

package/bin/termexo.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import {
+  RELEASES_URL,
+  findExecutable,
+  launchExecutable,
+  openDownloadPage,
+} from '../lib/launcher.js';
+
+const packageJsonPath = fileURLToPath(new URL('../package.json', import.meta.url));
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+const command = process.argv[2]?.toLowerCase() ?? 'start';
+
+function printHelp() {
+  console.log(`Termexo ${packageJson.version}
+
+Usage:
+  termexo              Start the installed Termexo desktop app
+  termexo start        Start the installed Termexo desktop app
+  termexo download     Open the latest Termexo release page
+  termexo --version    Print the launcher version
+  termexo --help       Show this help
+
+Set TERMEXO_PATH to the full path of termexo.exe when using a custom
+installation directory.`);
+}
+
+if (command === '--help' || command === '-h' || command === 'help') {
+  printHelp();
+} else if (command === '--version' || command === '-v' || command === 'version') {
+  console.log(packageJson.version);
+} else if (command === 'download') {
+  openDownloadPage();
+  console.log(`Opened ${RELEASES_URL}`);
+} else if (command === 'start') {
+  const executable = findExecutable();
+  if (!executable) {
+    console.error(`Termexo is not installed in a standard location.
+
+Download the Windows installer:
+  termexo download
+  ${RELEASES_URL}
+
+For a custom installation, set TERMEXO_PATH to the full path of termexo.exe.`);
+    process.exitCode = 1;
+  } else {
+    launchExecutable(executable);
+    console.log(`Started Termexo from ${executable}`);
+  }
+} else {
+  console.error(`Unknown command: ${process.argv[2]}`);
+  printHelp();
+  process.exitCode = 1;
+}

package/lib/launcher.js

@@ -0,0 +1,57 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { win32 } from 'node:path';
+
+export const RELEASES_URL = 'https://github.com/gemron/Termexo/releases/latest';
+
+export function executableCandidates(environment = process.env) {
+  const candidates = [];
+  const add = (value) => {
+    if (value && !candidates.includes(value)) {
+      candidates.push(value);
+    }
+  };
+
+  add(environment.TERMEXO_PATH);
+
+  if (environment.LOCALAPPDATA) {
+    add(win32.join(environment.LOCALAPPDATA, 'Termexo', 'termexo.exe'));
+    add(win32.join(environment.LOCALAPPDATA, 'Programs', 'Termexo', 'termexo.exe'));
+  }
+
+  if (environment.ProgramFiles) {
+    add(win32.join(environment.ProgramFiles, 'Termexo', 'termexo.exe'));
+  }
+
+  if (environment['ProgramFiles(x86)']) {
+    add(win32.join(environment['ProgramFiles(x86)'], 'Termexo', 'termexo.exe'));
+  }
+
+  return candidates;
+}
+
+export function findExecutable(environment = process.env, fileExists = existsSync) {
+  return executableCandidates(environment).find((candidate) => fileExists(candidate));
+}
+
+export function launchExecutable(executable, spawnProcess = spawn) {
+  const child = spawnProcess(executable, [], {
+    detached: true,
+    stdio: 'ignore',
+    windowsHide: false,
+  });
+  child.unref();
+}
+
+export function openDownloadPage(spawnProcess = spawn) {
+  const child = spawnProcess(
+    'rundll32.exe',
+    ['url.dll,FileProtocolHandler', RELEASES_URL],
+    {
+      detached: true,
+      stdio: 'ignore',
+      windowsHide: true,
+    },
+  );
+  child.unref();
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "termexo",
+  "version": "0.3.2",
+  "description": "Official Windows launcher for the Termexo AI development workspace",
+  "type": "module",
+  "bin": {
+    "termexo": "bin/termexo.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md"
+  ],
+  "os": [
+    "win32"
+  ],
+  "engines": {
+    "node": ">=18.18.0"
+  },
+  "scripts": {
+    "test": "node --test",
+    "prepublishOnly": "npm test"
+  },
+  "keywords": [
+    "termexo",
+    "terminal",
+    "ai",
+    "agent",
+    "claude",
+    "codex",
+    "desktop"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gemron/Termexo.git",
+    "directory": "packages/termexo"
+  },
+  "homepage": "https://www.termexo.com/",
+  "bugs": {
+    "url": "https://github.com/gemron/Termexo/issues"
+  },
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}