Use the CLI from AI Agents

​

The Contract

• JSON without asking. When stdout is not a terminal (which is every agent), commands print the exact API response as one JSON line. Errors are JSON envelopes on stderr with stable code fields and a requestId.
• Semantic exit codes. 0 success, 1 API or runtime error, 2 usage error, 3 authentication error, 4 confirmation required, 130 / 143 interrupted by SIGINT / SIGTERM. Unknown commands fail hard with no fuzzy “did you mean” to misread.
• Never hangs. Nothing waits on stdin unless it is a real terminal, and missing input is an immediate exit 2 with the fix in the message. Every request is bounded, response body included: --timeout <duration> (90s, 1500ms, 5m) caps the whole command, retries and pages included, so it fits a tool-call budget. Long-running commands such as emails generate default to their own budget. SIGINT or SIGTERM stops the request in flight.
• Stable surface. Commands and flags are additive across releases, and the manifest describes the installed build exactly.

​

Replaying an Unknown Outcome

{
  "error": {
    "code": "CLI_TIMEOUT",
    "type": "service_unavailable",
    "message": "No complete response within 60000ms (POST /v1/emails).",
    "idempotencyKey": "3f2a9c1e-…",
    "retryCommand": "brew-cli emails generate --prompt 'Welcome email' --timeout 60s --idempotency-key 3f2a9c1e-…"
  }
}

​

The Confirmation Protocol

{
  "confirmationRequired": true,
  "command": "brew-cli emails send",
  "summary": "Send email eml_123 as a REAL campaign to audience aud_9 now. Real recipients receive it; this cannot be undone.",
  "confirmCommand": "brew-cli emails send eml_123 --subject 'Fall sale' --audience aud_9 --domain dom_1 --yes"
}

​

Discovery for Agents

brew-cli docs --agent

​

A Typical Agent Session

brew-cli contacts count --json
brew-cli emails generate --prompt "Welcome email for new signups" --json
brew-cli emails send eml_abc --test --to qa@yourteam.com --subject "Preview"
brew-cli analytics overview --since 2026-08-01T00:00:00Z --json

​

Need Help?