overlord-cli 3.20.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

@@ -9,6 +9,18 @@ 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
 
@@ -52,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') {

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,6 +1,6 @@
 {
   "name": "overlord-cli",
-  "version": "3.20.0",
+  "version": "3.21.0",
   "description": "Overlord CLI — launch AI agents on tickets from anywhere",
   "type": "module",
   "bin": {
@@ -15,7 +15,7 @@
     "plugins/"
   ],
   "engines": {
-    "node": ">=24"
+    "node": ">=20"
   },
   "keywords": [
     "overlord",