CLI
prudai is the command line for all products, for people and agents. The product commands are generated from the OpenAPI specification. The CLI runs on Node 20 or newer.
Install
Section titled “Install”npx @prudai/cli --version # without installingnpm install --global @prudai/cli # or install it: the command is then called prudaiprudai --versionprudai login # Keycloak device loginprudai guide # the manual for agentsprudai products # products and number of operationsprudai ops search "risk" # search operations, with scope and approval levelprudai describe irma risks create # parameters, body and curl exampleprudai irma risks list --limit 5 --jsonCommands
Section titled “Commands”| Group | Commands |
|---|---|
| Discover | guide, products, ops search, ops list, describe |
| Product | prudai <product> <object> <verb> for leo, irma and ordo |
| Raw | api <METHOD> <path> --product <product> |
| Login | login, logout, whoami, auth status, profile |
| Keys | keys scopes, keys list, keys create, keys rotate, keys revoke |
| Account | account, account members, account seats, account subscription, account billing |
| Usage | credits, usage, logs, invoices |
| Approvals | approvals list, get, status, wait, execute, cancel; --wait on every write |
| MCP | mcp --check, mcp connections |
| Agent | skill install |
What the platform does not serve yet, the CLI answers with not_available and exit 2. It never pretends. The command names per operation are in the reference.
Rules for agents
Section titled “Rules for agents”--jsongives exactly one JSON document: the envelope, also forhelp.- Writes are a dry run by default where the spec has one; otherwise nothing leaves. Really writing asks for
--no-dry-run --yes. - Every write gets an
Idempotency-Key.--idempotency-keyreuses it. - Approvals: a
202gives the link and the next command. The CLI never approves by itself and never pays. - No secrets in output. Credentials come from the environment or the config file, never from a flag.
Exit codes
Section titled “Exit codes”| Code | Meaning |
|---|---|
0 | Done |
1 | Network or server; check the state before you repeat a write |
2 | You must do something: validation, login, refused, not_available, waiting approval |
The CLI never logs in with a key. prudai keys manages service keys for your own applications, with your Keycloak login. You see the secret value once.