@volatodev/cli

The agent-facing CLI for Volato — agent-native error tracking.

Install it once. Your AI agent (Claude Code, Cursor, …) shells out to volato from any terminal to read, triage, and resolve errors — getting the full fix context (stack, originating commit, source location) in a single call.

Install

npm install -g @volatodev/cli

Authenticate

volato login <token>      # workspace token from https://app.volato.dev
volato whoami             # confirm who you're authenticated as

The token is stored at ~/.config/volato/credentials (mode 0600). Override the location with VOLATO_CREDENTIALS_FILE or the standard XDG_CONFIG_HOME.

Commands

volato errors list                       # browse open error groups
volato errors show <id>                   # one-call fix context for a group
volato errors show                        # most-recent unresolved across the workspace
volato errors resolve <id> --note "..."  # mark resolved (append-only history)
volato errors reopen <id>
volato errors ignore <id>
volato init                               # wire @volatodev/nextjs into a Next.js app
volato readme                             # print every command (point your agent here)

Every command prints agent-ready markdown by default. Pass --json for the structured payload, scriptable exit codes for the rest (3 auth, 4 not-found, 5 rate-limited).

For agents

Tell your agent to run volato readme once — it discovers the whole surface in a single call, then drives the loop: errors list → errors show <id> → fix → errors resolve <id>.

Self-hosting

The API base defaults to https://api.volato.dev and is overridable for self-hosted deployments via VOLATO_API_URL.

License

MIT © Wrenchy SASU