CLI command reference

Every command accepts --help for inline usage. Commands marked with --json support machine-readable output suitable for piping into jq or other tools.

Top-level flags

• --version — Print the installed CLI version and exit
• --help — Show help for the CLI or any subcommand
• --json — Emit JSON instead of formatted text (supported on most read commands)

Authentication

• autousers login — Persist an API key to ~/.autousers/config.json (prompts interactively)
• autousers login --key ak_live_... — Persist a key without a prompt
• autousers logout — Remove the local config file (does not revoke the key)
• autousers whoami — Print the email, user id, and active team for the resolved key

Evaluations

• autousers eval list [--json] — List evaluations on the active team
• autousers eval get <id> [--json] — Fetch one evaluation by id
• autousers eval create — Launch the interactive create wizard
• autousers eval create --type SSE --url <url> --title <title> — Create a single-sided evaluation
• autousers eval create --type SxS --url-a <url> --url-b <url> --title <title> — Create a side-by-side evaluation
• autousers eval run <id> — Dry-run preview of cost (default — no tokens spent)
• autousers eval run <id> --commit — Confirm the preview and queue real autouser runs
• autousers eval results <id> [--json] — Aggregate scores, per-rater summaries, agreement
• autousers eval export <id> --format csv|json — Export raw ratings

Autousers

• autousers autouser list [--json] — List built-in and custom autousers visible to the active team

Templates

• autousers template list [--json] — List question templates on the active team

Usage

• autousers usage [--json] — Print free-run pool remaining, Gemini token spend for the active team