overlord-cli

library0.2606041635.0jsnpmunverified

Overlord CLI is the command-line interface for launching AI agents on tickets from any environment. Current stable version is 0.2606041635.0. Released irregularly as part of the Overlord monorepo. Key differentiators: supports multiple AI connectors (Claude, Codex, Cursor, Antigravity), provides a unified protocol for ticket lifecycle management, and includes setup/authentication workflows. Requires Node.js >= 20. ESM-only, no CommonJS. CLI commands are available via `ovld` or `overlord`.

devops

npm install overlord-cli

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · OVERLORD-CLI

overlord-cli

devopsjavascriptv0.2606041635.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ovld

✓ npx overlord-cli <command>

✗ npm run overlord

Use npx or global install; the package is a CLI, not a library.

overlord

✓ npx overlord-cli <command>

✗ require('overlord-cli')

Both 'ovld' and 'overlord' are aliases for the CLI; do not import as a module.

Installs the CLI globally, sets the Overlord URL, authenticates with an API key, creates a ticket with the Codex agent, and logs out.

npm install -g overlord-cli@0.2606041635.0 export OVERLORD_URL=${OVERLORD_URL:-https://www.ovld.ai} ovld auth login --token ${OVERLORD_API_KEY:-''} ovld create "Investigate the failing build" --agent codex ovld auth logout

Debug

Known issues

breakingGemini CLI is deprecated. Use ovld setup antigravity and ovld launch antigravity --ticket-id <ticket_id>. Antigravity manages model selection internally.

fix

Replace any usage of 'gemini' connector with 'antigravity'.

affects: >=0.0.0

gotchaovld auth login stores your identity only and never a default organization. Commands that browse or search span every organization you belong to.

fix

Use --organization-id for actions against a specific org, or rely on ticket_id (contains org id).

affects: >=0.0.0

gotchaWhen ovld launch has --working-directory or runs from a registered project directory containing .overlord/project.json, it overrides TMPDIR/TMP/TEMP/OVERLORD_TMPDIR to that project's .overlord/tmp/ directory.

fix

Be aware of environment variable changes; use absolute paths if needed.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'overlord-cli'

Running without installing or using npx in a directory that doesn't have the package.

fix

npm install -g overlord-cli or npx overlord-cli <command>

Error: Failed to authenticate: Unauthorized

Invalid or expired token, or no token provided.

fix

Run ovld auth login with a valid token (use --token or set OVERLORD_API_KEY).

Upgrade

Version history

0.2606041635.0latest on npm

Audit

Dependencies

noderequiredRuntime engine requirement: Node.js >= 20

Agent activity

9 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/cooperativ-labs/overlord/packages/overlord-cli ↗

packageoverlord-cli ↗

homepagehttps://www.ovld.ai/docs/ ↗