CLI overview - Cralo

The cralo CLI is the interface AI agents use for tool discovery, execution, billing, and diagnostics. Its stable JSON contract is designed for programmatic use.

Install

npm install --global @cralo/cli@stable
cralo --version
cralo doctor --json

The CLI requires Node.js 22 or newer and supports macOS, Linux, WSL, and native Windows. Existing @opentooler/cli installations and the opentooler command remain supported as compatibility aliases. New installations should use @cralo/cli and cralo.

Command areas

Area	Commands
Authentication	`auth login`, `auth logout`, `auth status` (aliases: `login`, `logout`, `status`)
Tools	`tools list`, `search`, `describe`, `quote`, `call`
Invocations	`invocations list`, `get`
Billing	`billing balance`, `billing topup`, `billing receipts list`, `billing receipts get`
Diagnostics	`doctor`
Feedback	`feedback <text>`
MCP	`mcp serve`, `integrations configure <host>`

Global output options

Option	Behavior
`--json`	Write one stable JSON envelope to stdout.
`--output human`	Default human-readable output.
`--output json`	Equivalent structured JSON output.
`--output ndjson`	Newline-delimited progress events for calls.
`--output text`	Plain text output.
`--quiet`	Suppress progress messages on stderr.

AI agents should use --json and treat stdout as structured data. Do not parse human-readable output.

Feedback

cralo feedback "<text>" --json

Sends free-text feedback to Cralo. Requires authentication (same as any authenticated command). Pass serialized JSON as the quoted text for structured feedback.