overlord-cli 3.18.0 → 3.21.0

package/README.md

@@ -12,6 +12,8 @@ Install it globally so the `ovld` and `overlord` commands are available on your
 npm install -g overlord-cli
 ```
 
+Use Node.js 20 or newer for every CLI install or update.
+
 ## Usage
 
 ```bash
@@ -38,7 +40,7 @@ ovld doctor
 
 ## Requirements
 
-- Node.js 24 or newer
+- Node.js 20 or newer
 - Access to an Overlord instance when using authenticated commands
 
 ## Commands

package/bin/_cli/index.mjs

@@ -3,13 +3,24 @@
 import { runAttachCommand } from './attach.mjs';
 import { runAuthCommand } from './auth.mjs';
 import { runLauncherCommand } from './launcher.mjs';
-import { runCreateCommand, runPromptCommand } from './new-ticket.mjs';
 import { runProtocolCommand } from './protocol.mjs';
 import { runDoctorCommand, runSetupCommand } from './setup.mjs';
 import { runTicketCommand } from './ticket.mjs';
 import { runTicketsCommand } from './tickets.mjs';
 import { runVersionCommand } from './version.mjs';
 
+const MIN_NODE_MAJOR = 20;
+
+function assertSupportedNodeVersion() {
+  const major = Number.parseInt(process.versions.node.split('.')[0] ?? '', 10);
+  if (Number.isNaN(major) || major < MIN_NODE_MAJOR) {
+    throw new Error(
+      `Overlord CLI requires Node.js ${MIN_NODE_MAJOR} or newer. Found ${process.version}.\n` +
+      `Update Node before running \`ovld\`. If you installed the desktop wrapper, you can also point it at a newer runtime with \`OVLD_NODE_BIN=/path/to/node\`.`
+    );
+  }
+}
+
 function printHelp(primaryCommand) {
   console.log(`Overlord CLI
 
@@ -53,6 +64,7 @@ Run a subcommand with --help for more detail.
 }
 
 export async function runCli({ primaryCommand }) {
+  assertSupportedNodeVersion();
   const [command, ...rest] = process.argv.slice(2);
 
   if (!command || command === 'help' || command === '--help' || command === '-h') {
@@ -67,11 +79,13 @@ export async function runCli({ primaryCommand }) {
   }
 
   if (command === 'create') {
+    const { runCreateCommand } = await import('./new-ticket.mjs');
     await runCreateCommand(rest);
     return;
   }
 
   if (command === 'prompt') {
+    const { runPromptCommand } = await import('./new-ticket.mjs');
     await runPromptCommand(rest);
     return;
   }

package/bin/_cli/new-ticket.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import readline from 'node:readline/promises';
+import readline from 'node:readline';
 import { stdin as input, stdout as output } from 'node:process';
 
 import { buildAuthHeaders, resolveAuth } from './credentials.mjs';
@@ -90,6 +90,19 @@ async function promptForSelection({ items, label, prompt, renderItem }) {
   }
 
   const rl = readline.createInterface({ input, output });
+  const question = promptText =>
+    new Promise((resolve, reject) => {
+      const handleError = error => {
+        rl.off('error', handleError);
+        reject(error);
+      };
+
+      rl.once('error', handleError);
+      rl.question(promptText, answer => {
+        rl.off('error', handleError);
+        resolve(answer);
+      });
+    });
 
   try {
     while (true) {
@@ -98,7 +111,7 @@ async function promptForSelection({ items, label, prompt, renderItem }) {
         output.write(`  ${index + 1}. ${renderItem(item, index)}\n`);
       });
 
-      const answer = await rl.question(`\n${prompt} `);
+      const answer = await question(`\n${prompt} `);
       const selectedIndex = parseNumberedSelection(answer, items.length);
       if (selectedIndex !== null) {
         return items[selectedIndex];

package/bin/_cli/setup.mjs

@@ -32,6 +32,7 @@ const CODEX_TARGET_RULES = path.join(os.homedir(), '.codex', 'rules', 'default.r
 const CODEX_LEGACY_AGENTS = path.join(os.homedir(), '.codex', 'AGENTS.md');
 const CODEX_RULES_START = '# overlord:permissions:start';
 const CODEX_RULES_END = '# overlord:permissions:end';
+const REQUIRED_NODE_MAJOR = 20;
 
 const supportedAgents = ['claude', 'codex', 'cursor', 'gemini', 'opencode'];
 
@@ -971,6 +972,10 @@ function doctorAgent(agent) {
   return true;
 }
 
+function currentNodeMajor() {
+  return Number.parseInt(process.versions.node.split('.')[0] ?? '', 10);
+}
+
 // ---------------------------------------------------------------------------
 // Public API
 // ---------------------------------------------------------------------------
@@ -1033,6 +1038,16 @@ export async function runSetupCommand(args) {
 export async function runDoctorCommand() {
   console.log('Overlord agent bundle status:\n');
   let allOk = true;
+  const nodeMajor = currentNodeMajor();
+  if (Number.isNaN(nodeMajor) || nodeMajor < REQUIRED_NODE_MAJOR) {
+    console.log(
+      `  ✗ node: unsupported runtime (${process.version}; requires Node.js ${REQUIRED_NODE_MAJOR}+)`
+    );
+    allOk = false;
+  } else {
+    console.log(`  ✓ node: ${process.version}`);
+  }
+  console.log();
   for (const agent of supportedAgents) {
     if (!doctorAgent(agent)) allOk = false;
   }
@@ -1046,6 +1061,8 @@ export async function runDoctorCommand() {
   if (latestCliVersion) {
     console.log();
     console.log(`CLI update available: ${latestCliVersion}`);
-    console.log('Run `npm install -g overlord-cli@latest` to update.');
+    console.log(
+      `Update with Node.js ${REQUIRED_NODE_MAJOR}+ and reinstall the installed CLI wrapper if needed.`
+    );
   }
 }

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "overlord-cli",
-  "version": "3.18.0",
+  "version": "3.21.0",
   "description": "Overlord CLI — launch AI agents on tickets from anywhere",
-  "private": false,
   "type": "module",
   "bin": {
     "overlord": "bin/ovld.mjs",
@@ -16,7 +15,7 @@
     "plugins/"
   ],
   "engines": {
-    "node": ">=24"
+    "node": ">=20"
   },
   "keywords": [
     "overlord",