orboto CLI

The command-line client for orboto - ticket and project management built API-first for humans and AI agents. A single static Go binary (no runtime dependencies); this npm package is a thin installer that pulls the right platform binary via optionalDependencies and execs it.

Install

npm install -g orboto      # or: npx orboto <command>

Without npm:

curl -fsSL https://raw.githubusercontent.com/orboto/orboto-cli/main/install.sh | sh

Configure

The CLI reads, in order: environment variables, ./.orboto.env, ~/.orboto/env.

ORBOTO_BASE_URL=https://your-instance.example.com/api
ORBOTO_TOKEN=orb_...        # API key - keep it in the env file, there is no --token flag on purpose

Use

orboto whoami                       # verify the connection
orboto ticket ACME-42 --full        # read a ticket
orboto create-ticket ACME "fix: ..." --type bug
orboto work-start ACME-42           # lease + full context bundle
orboto work-next ACME               # pull the best ready ticket
orboto query "status = open AND assignee = me"
orboto get /projects                # generic verbs reach the whole REST API
orboto self-update                  # opt-in update to the latest release

Run orboto with no arguments for the full command list.

Notes

• Supported platforms: linux/darwin x64 + arm64, windows x64 (@orboto/cli-* packages).
• orboto version always matches this package's version.
• Issues + releases: https://github.com/orboto/orboto-cli.