overlord-cli
v3.23.0
Published
Overlord CLI — launch AI agents on tickets from anywhere
Downloads
1,554
Readme
Overlord CLI
overlord-cli is the packaged command-line interface for Overlord. It lets you launch agents on tickets, create new tickets, and manage the ticket lifecycle from the terminal.
Website: ovld.ai
Install
Install it globally so the ovld and overlord commands are available on your PATH:
npm install -g overlord-cliUse Node.js 20 or newer for every CLI install or update.
Run ovld update any time you want to refresh the global npm install to the latest release.
Usage
ovld help
overlord helpThe CLI exposes the same command set under both names.
ovld auth login opens a browser when possible and also prints a verification URL/code so login can be completed from another machine over SSH.
Common commands:
ovld auth login
ovld attach
ovld create "Investigate the failing build"
ovld prompt "Draft a fix for the onboarding flow"
ovld update
ovld protocol discover-project
ovld protocol attach --ticket-id <ticket-id>
ovld protocol update --session-key <session-key> --ticket-id <ticket-id> --summary "Working on it" --phase execute
ovld setup codex
ovld setup cursor
ovld setup gemini
ovld setup all
ovld doctorRequirements
- Node.js 20 or newer
- Access to an Overlord instance when using authenticated commands
Commands
attach- search tickets and launch an agent interactivelycreate- create a ticket from a short objectiveprompt- create a ticket and launch an agent on itauth- log in, log out, or check auth statustickets- list or create ticketsticket- work with a single ticketprotocol- run ticket lifecycle commands such asdiscover-project,attach,connect,load-context,spawn,update,record-change-rationales,ask,read-context,write-context,deliver, and artifact upload/download helpersconnect,restart,context- launch or resume an agent session or print ticket contextrun,resume- legacy aliases forconnectandrestartsetup- install the Overlord connector or plugin bundle for a supported agentupdate- install the latest CLI release from npmdoctor- verify installed agent connectors and check whether a newer CLI version is available
License
Permission is granted to use this software for any purpose, free of charge. You may not modify, distribute, sublicense, or sell copies of the software without explicit permission from the author.
