aoctl

Overview ¶

Command aoctl is the CLI for integrating with agent-orca's external APIs.

It targets the External Task API (default http://localhost:8084) for task submission/polling/streaming and the ACP API (default http://localhost:8000) for agent discovery. Authentication is pluggable:

• `oauth` — OAuth2 client_credentials exchange at POST /oauth/token (agent-orca-issued tenant JWT).
• `oidc` — OIDC authorization-code flow (browser + loopback callback). The resulting id_token is presented directly as a bearer token; the server validates it via the federated issuer's JWKS.

`aoctl login` (with no credentials) presents an interactive selection menu so users can pick their login method; pass --auth-method to run non-interactively.