CLI
prudai is de opdrachtregel voor alle producten, voor mensen en agents. De productcommando’s worden gegenereerd uit de OpenAPI-specificatie. De CLI draait op Node 20 of nieuwer.
Installeren
Section titled “Installeren”npx @prudai/cli --version # zonder installatienpm install --global @prudai/cli # of vast op je machine: dan heet het commando prudaiprudai --versionprudai login # Keycloak-device-loginprudai guide # de handleiding voor agentsprudai products # producten en aantal operatiesprudai ops search "risico" # operaties zoeken, met scope en goedkeuringsniveauprudai describe irma risks create # parameters, body en curl-voorbeeldprudai irma risks list --limit 5 --jsonCommando’s
Section titled “Commando’s”| Groep | Commando’s |
|---|---|
| Ontdekken | guide, products, ops search, ops list, describe |
| Product | prudai <product> <object> <werkwoord> voor leo, irma en ordo |
| Rauw | api <METHOD> <pad> --product <product> |
| Inloggen | login, logout, whoami, auth status, profile |
| Sleutels | keys scopes, keys list, keys create, keys rotate, keys revoke |
| Account | account, account members, account seats, account subscription, account billing |
| Gebruik | credits, usage, logs, invoices |
| Goedkeuringen | approvals list, get, status, wait, execute, cancel; --wait op elke schrijfactie |
| MCP | mcp --check, mcp connections |
| Agent | skill install |
Wat het platform nog niet serveert, beantwoordt de CLI met not_available en exit 2. Hij doet nooit alsof. De commandonamen per operatie staan in de referentie.
Regels voor agents
Section titled “Regels voor agents”--jsongeeft precies één JSON-document: de envelop, ook bijhelp.- Schrijfacties zijn standaard een dry run waar de spec die heeft; anders gaat er niets de deur uit. Echt schrijven vraagt
--no-dry-run --yes. - Elke schrijfactie krijgt een
Idempotency-Key. Met--idempotency-keyhergebruik je hem. - Goedkeuringen: een
202geeft de link en de vervolgopdracht. De CLI keurt nooit zelf goed en betaalt nooit. - Geen secrets in uitvoer. Credentials komen uit de omgeving of het configbestand, nooit uit een flag.
Exitcodes
Section titled “Exitcodes”| Code | Betekenis |
|---|---|
0 | Klaar |
1 | Netwerk of server; controleer de toestand voor je een schrijfactie herhaalt |
2 | Jij moet iets doen: validatie, inloggen, geweigerd, not_available, wachtende goedkeuring |
Sleutels
Section titled “Sleutels”De CLI logt nooit in met een sleutel. prudai keys beheert servicesleutels voor je eigen applicaties, met jouw Keycloak-login. De geheime waarde zie je eenmalig.