@dhruv2mars/offdex 0.0.6 → 0.0.8

package/README.md

@@ -25,9 +25,10 @@ Supported targets:
 Common usage:
 
 ```bash
+offdex
+offdex help
 offdex start --host 0.0.0.0 --port 42420
 offdex start --control-plane-url https://control.offdex.app
 offdex status
 offdex stop
-offdex --help
 ```

package/bin/offdex.js

@@ -13,54 +13,111 @@ import {
 } from "./offdex-lib.js";
 
 const args = process.argv.slice(2);
-const ONBOARDING_TEXT = `Offdex
-Codex from your phone.
+const colorEnabled =
+  Boolean(process.stdout.isTTY) &&
+  process.env.NO_COLOR !== "1" &&
+  process.env.NO_COLOR !== "true" &&
+  process.env.TERM !== "dumb";
+const paint = (code, text) => colorEnabled ? `\u001b[${code}m${text}\u001b[0m` : text;
+const green = (text) => paint("38;2;16;163;127", text);
+const muted = (text) => paint("38;2;156;163;160", text);
+const bold = (text) => paint("1", text);
+const command = (text) => paint("38;2;225;229;226", text);
+const link = (text) => paint("38;2;203;255;229", text);
 
-Get started:
-  1. Run offdex start
-  2. Open Offdex on your phone
-  3. Scan the QR from this terminal
+function onboardingText() {
+  return [
+    bold(green("Offdex")),
+    muted("Codex mobile app."),
+    "",
+    "Use Codex from your phone while the real Codex session keeps running on this Mac.",
+    "",
+    green("Get started"),
+    `  1. Run ${command("offdex start")}`,
+    "  2. Open Offdex on your phone.",
+    "  3. Scan the QR from this terminal.",
+    "  4. Send a prompt and watch Codex reply live.",
+    "",
+    green("Core commands"),
+    `  ${command("offdex help")}       Commands, docs, GitHub, feedback.`,
+    `  ${command("offdex start")}      Start the bridge and show the QR.`,
+    `  ${command("offdex status")}     Show bridge, Codex, and client status.`,
+    `  ${command("offdex stop")}       Stop the local bridge.`,
+    "",
+    `Docs: ${link("https://offdexapp.vercel.app")}`,
+  ].join("\n");
+}
 
-Useful commands:
-  offdex start      Start the Mac bridge
-  offdex status     Check if Offdex is running
-  offdex stop       Stop the local bridge
-  offdex --help     Show all options
-`;
-const HELP_TEXT = `Offdex CLI
+function helpText() {
+  return [
+    bold(green("Offdex help")),
+    muted("Codex mobile app."),
+    "",
+    green("Commands"),
+    `  ${command("offdex")}`,
+    "      Open the Offdex home screen.",
+    "",
+    `  ${command("offdex help")}`,
+    "      Show commands, docs, and support links.",
+    "",
+    `  ${command("offdex start")} ${muted("[options]")}`,
+    "      Start the bridge and show the pairing QR.",
+    "",
+    `  ${command("offdex status")} ${muted("[options]")}`,
+    "      Show bridge, Codex, client, and remote status.",
+    "",
+    `  ${command("offdex stop")} ${muted("[options]")}`,
+    "      Stop the local bridge started by Offdex.",
+    "",
+    green("Start options"),
+    `  ${command("--host <host>")}                 Default: 0.0.0.0`,
+    `  ${command("--port <port>")}                 Default: 42420`,
+    `  ${command("--mode <codex|demo>")}           Default: codex`,
+    `  ${command("--control-plane-url <url>")}     Enable managed remote pairing.`,
+    "",
+    green("Environment fallbacks"),
+    `  ${command("OFFDEX_BRIDGE_HOST")}`,
+    `  ${command("OFFDEX_BRIDGE_PORT")}`,
+    `  ${command("OFFDEX_BRIDGE_MODE")}`,
+    `  ${command("OFFDEX_CONTROL_PLANE_URL")}`,
+    "",
+    green("Links"),
+    `  Docs:     ${link("https://offdexapp.vercel.app")}`,
+    `  GitHub:   ${link("https://github.com/Dhruv2mars/offdex")}`,
+    `  Feedback: ${link("https://github.com/Dhruv2mars/offdex/issues")}`,
+  ].join("\n");
+}
 
-Usage:
-  offdex
-  offdex start [options]
-  offdex status [options]
-  offdex stop [options]
-  offdex --help
+function offlineText() {
+  return [
+    bold("Offdex is not running"),
+    `Start it with: ${command("offdex start")}`,
+  ].join("\n");
+}
 
-Commands:
-  start                         Start the Mac bridge and show the pairing QR
-  status                        Check the local bridge
-  stop                          Stop the local bridge started by Offdex
+function commandName(argv) {
+  return argv[0] ?? "onboarding";
+}
 
-Options:
-  --host <host>                 Bridge host. Default: 0.0.0.0
-  --port <port>                 Bridge port. Default: 42420
-  --mode <codex|demo>           Bridge runtime mode. Default: codex
-  --control-plane-url <url>     Managed remote control plane URL
-  -h, --help                    Show help
+function canAnswerWithoutRuntime(argv) {
+  const name = commandName(argv);
+  return (
+    argv.length === 0 ||
+    name === "help" ||
+    name === "--help" ||
+    name === "-h" ||
+    name === "status" ||
+    name === "stop"
+  );
+}
 
-Environment fallbacks:
-  OFFDEX_BRIDGE_HOST
-  OFFDEX_BRIDGE_PORT
-  OFFDEX_BRIDGE_MODE
-  OFFDEX_CONTROL_PLANE_URL
-`;
 const installedBin = resolveInstalledBin(process.env, process.platform);
 const packageVersion = readPackageVersion();
 const currentInstalledVersion = installedVersion(process.env);
 const workspaceBridgeCli = resolveWorkspaceBridgeCli();
 
 if (!existsSync(installedBin) && args.length === 0) {
-  console.log(ONBOARDING_TEXT);
+  console.log(onboardingText());
   process.exit(0);
 }
 
@@ -68,7 +125,7 @@ if (
   !existsSync(installedBin) &&
   (args[0] === "help" || args[0] === "--help" || args[0] === "-h")
 ) {
-  console.log(HELP_TEXT);
+  console.log(helpText());
   process.exit(0);
 }
 
@@ -80,7 +137,18 @@ if (workspaceBridgeCli && !existsSync(installedBin)) {
   process.exit(result.status ?? 1);
 }
 
+if (!existsSync(installedBin) && args[0] === "status") {
+  console.log(offlineText());
+  process.exit(1);
+}
+
+if (!existsSync(installedBin) && args[0] === "stop") {
+  console.log(offlineText());
+  process.exit(0);
+}
+
 if (
+  !canAnswerWithoutRuntime(args) &&
   shouldInstallBinary({
     binExists: existsSync(installedBin),
     installedVersion: currentInstalledVersion,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dhruv2mars/offdex",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Codex mobile bridge CLI for Offdex",
   "type": "module",
   "bin": {
@@ -14,7 +14,6 @@
   },
   "scripts": {
     "offdex": "node bin/offdex.js",
-    "postinstall": "node bin/install.js",
     "build": "node -e \"process.exit(0)\"",
     "check": "node --check bin/offdex.js && node --check bin/offdex-lib.js && node --check bin/install.js && node --check bin/install-lib.js && node --test test/*.test.js",
     "test": "node --test test/*.test.js"