CLI changelog
Release notes for @k9o/cli, from the CHANGELOG.md in the k9o-cli repository. Read on 17 November 2026 at 15:55 UTC.
1.5.2
Changed
- The
tierGatingoption is removed from sign-in provider creation; the platform no longer gates features by plan. - README: Architecture at a glance, illustrations, and the package table lists only the packages for that SDK.
1.5.0
Added
command-manifest.json, shipped in the package and generated from the CLI's own source withbun run manifest: every command with its usage line, a runnable sample, its flags and the SDK methods it calls (written as the OpenAPIx-sdk-methodfield writes them). A command that calls a gateway route directly, such ask9o ext-admin list, lists that route inrestRoutesand inrestRouteIndex. A test fails when the file is stale or names an SDK method the client does not have.- Short forms for the three flags every command shares:
-Ofor--org,-Pfor--projectand-pfor--profile. The long forms stay canonical. - Keyless CI sign-in works with the default (key-bound) workload: the CLI keeps the exchange key in memory and sends a fresh DPoP proof with every request (method, URL and a hash of the token), so commands after the exchange are admitted. A workload registered in bearer mode keeps sending the plain Bearer token.
k9o idp list|create|update|testfor the identity providers your project's end users sign in with (project admin). The client secret is read from--client-secret-envor--client-secret-file, never from a flag.k9o me api-tokens create --tier readonly|readwrite|adminreplaces--operations: a token has one tier, sent asscopeManifest.tier, andlistshows it. A readonly token can still decrypt (decrypt counts as a read). Needs the gateway release that carries the tiers; the olderoperationsform stops working at that release.k9o crypto mode --crypt NAMEasks about that crypt (GET /crypto/mode?crypt=NAME), so a personal access token or workload policy scoped to named crypts can read the mode. Without it the call is unchanged.k9o crypto federated-token --crypt K [--op encrypt|decrypt|rewrap] --out FILE|--out-fd N|--out - [--force]writes the short-lived identity token for your own cloud's token exchange to a file (mode 0600, an existing file refused unless--force), an open file descriptor (3 or higher) or, only when asked, stdout. Without a destination it is a usage error. stdout otherwise showsexpiresAt,issuer,subject,audienceandkid, never the token.k9o keys list [--all]|get <key-id>|rotate <key-id>for the project's encryption keys (metadata only).listis not paged.rotateneeds a fresh MFA step-up: when it is missing the CLI prints the requirement and the challenge, exits 66 and does not retry.rotate --step-up-proof-cmd '<command>'answers the challenge with your command: the challenge is JSON on its stdin, the method and URL are inK9O_STEPUP_METHODandK9O_STEPUP_URL, and it prints{"method":"dpop|mtls|webauthn","proof":"..."}. The rotation is sent once more with the proof; the proof is never printed.k9o crypto encrypt|decrypt|rewrap --crypt K [--context C] [--in FILE|-] [--out FILE|-] [--encoding utf8|base64]for server-side encryption with the project's platform-managed key (encrypt checks the project's custody mode on every call; a project whose key is held in your own KMS or HSM, BYOK or HYOK, getsK9O_ZK_CLIENT_CORE_UNAVAILABLE, exit 73, with nothing sent, and should use client-sidekibo.encryptandkibo.decrypt; an unknown or missing custody mode answer fails withK9O_CRYPTO_CUSTODY_UNKNOWNand a failed mode call shows its own error, neither sending anything),k9o crypto modeto print the custody mode and epoch,, and--items-file FILEfor a batch of up to 100. Nothing is retried; errors print with their code (for exampleK9O_ENVELOPE_INTEGRITY_FAILURE, exit 70).k9o audit replay [--after-audit-event-id ID | --from-sequence N] [--limit N]prints one page of audit events in order (events,nextCursor,hasMore).k9o analytics(aliasesdataset,datasets):list|get|create|delete|query|read|materialize|write|upload|download-original, plusrollups create|list|delete|reattest <dataset>andschedules create|list|delete|reattest <dataset>.uploadtakes a file path (format from the extension,--dry-runto preview);download-original --out <file>saves the original upload.reattestis human-only: a service, workload or extension token is refused (K9O_RBAC_DENY, exit 67).k9o rollups list|read|subscribe;subscribefollows a rollup live, one cell (the payload) per line, until interrupted or--count. A suppressed cell shows its status and reason; a cell the stream re-sends prints once.k9o audit tail [--type T ...] [--json]now follows the audit log live, one event per line, until interrupted (Ctrl-C exits 0).--typemay be repeated.--jsonis the same as--output json. Each event hasauditEventId,type,actorType,occurredAt,outcomeandeventId(the stream message's id), and prints once.k9o audit recent [--since-minutes N] [--limit N]is the previous one-off fetch of recent events (it wasaudit tail).k9o metadata filter|set|search|nearest|index get|index declarefor declared metadata columns.filter --surface <s> [--where <json>] [--limit N] [--cursor c]printsMore: --cursor <c>when another page exists;set <collection> <id> --set <json>;search --surface S --field F --q Q;nearest --surface S --column C --embedding <json>|--embedding-file <path|-> [--k N] [--metric M];index declare <collection> --columns <json>replaces the declaration. Column names get themetadata.prefix when omitted.k9o approvals listtakes--cursorand printsMore: --cursor <c>when another page exists.k9o approvals bulkprints the rows that failed (id code reason) after the decided ids; the call itself still succeeds.k9o approvals comment <id> --body <text> --visibility everyone|approvers_onlyposts a comment on a pending change (--visibilityis required, there is no default) andk9o approvals comments <id> [--limit N] [--cursor c]lists the comments you may see, oldest first, withMore: --cursor <c>when another page exists.k9o custody statusshows the project's key custody: mode, whether an external source is attached, provider, last job and, for an HSM, vendor, cluster and region (--output jsonprints the gateway answer). Read-only; needs the project-admin or project-auditor role.k9o data insert|update|deletewrite one record;--require-approvalqueues the write and prints the change id to decide withk9o approvals.--datatakes JSON inline,@file, or-for stdin.k9o function trigger list|create|update|deletefor a function's event triggers.createtakes--collection,--events insert,update,--filter,--disabledand--log-ok-invocations;updatealso takes--clear-filter,--enableand--disable.k9o schedule list|get|create|update|delete|runs|run-nowfor scheduled triggers.createtakes--function,--cron,--timezone,--catchup,--collection,--disabledand--log-ok-invocations. A schedule interval under 5 minutes is rejected with 400K9O_INVALID_FIELD_VALUE(fieldschedule_expression), on every plan.k9o end-user list|getandk9o end-user role-grant list|grant|revoke. A role is any string; revoking an unknown grant printsrevoked: false.k9o vectors nearest <collection> --vector <json>|--vector-file <path|-> [--top-k N] [--min-score X] [--metric cosine|euclidean|dot] [--filters <json>]finds the nearest stored embeddings, closest first.k9o vectors upsert <collection> --rows <json>|--rows-file <path|->stores 1 to 1000 rows. The collection name starts with_.- README sections for the new commands.
- README: what an event-trigger function receives (the JSON payload, redaction,
triggeredAt, and deduping oneventId).
Fixed
- Every secret prompt (
k9o login,byos cred,vault secret create|update) is read without echo on a terminal.k9o loginno longer takes--password, since a password on the command line shows in shell history and the process list: type it at the prompt or setK9O_PASSWORDin a script. Passing the flag is a usage error and sends nothing. k9o loginwaited for the email and then exited without asking for the password, because the second prompt read from a stream the first had paused. The email, password and MFA prompts now share one reader, so lines typed or piped together are each used in turn, and the password is no longer echoed.k9o inituses the same reader.- A gateway error whose
recommendationis an object printed[object Object], and during a workload token exchange it crashed withacc.split is not a function, hiding the real code and exit status. The action text is printed, and the exchange keeps the gateway's code, message and status.--output jsonerrors addretryAfterSecwhen the gateway asks you to wait.
1.4.0 — 2026-10-26
Added
k9o ai generate <prompt|-> [--model <id>] [--max-tokens N] [--temperature T]prints generated text; usage goes to stderr.k9o stream create|list|get|delete|publish|tail|replayfor a project's data streams.k9o stream publish <slug> --data <json|@file|->(stdin with-) and--subject.k9o stream tail <slug> [--from <sequence>] [--count <n>]follows a stream live, one event per line (JSON lines with--output json). It reopens the connection from the last sequence and runs until interrupted.k9o stream replay <slug> [--from N] [--until N] [--limit N]reads a bounded range.- A lone
-is accepted as a flag value, so--data -reads stdin. k9o approvals list|get|approve|reject|bulkfor the pending-change queue.approvereports when more approvers are needed.bulk --action approve|reject --criteria '<json>' [--reason <text>]prints the ids it decided; rows that fail are skipped without a report.k9o approval-policy list|create|delete;createtakes--collection,--operation,--actionand--predicate '<json>'.k9o schema collections [--limit N] [--cursor c]lists the project's collections and prints the cursor of the next page.- README sections for
k9o query,k9o searchand the new commands. - Keyless sign-in from CI.
--workload-id swi_...(orK9O_WORKLOAD_ID) exchanges an external OIDC token for a short-lived platform token, held in memory for the run. - The OIDC token comes from
--oidc-token-file,K9O_OIDC_TOKEN, or the GitHub Actions token endpoint (--oidc-audience/K9O_OIDC_AUDIENCE; the job needspermissions: id-token: write). k9o whoamireportsfederated-workloadmode with the workload, org, project and token lifetime.- Known limit: the exchanged token has no project grants yet, so commands after the exchange are refused. Use
K9O_SERVICE_TOKENto run commands in CI until then.
Changed
- Function deploy examples use the sandbox tier.
1.3.0 — 2026-10-26
The CLI now matches the gateway routes exactly.
Changed
k9o loginsigns in as the operator. MFA comes from--mfa-code,K9O_MFA_CODEor a prompt.--projectis optional.- Password sign-in is the interim method until browser-based device authorization lands.
K9O_SERVICE_TOKENsigns in CI runs with no login.K9O_ORGandK9O_PROJECTapply to every command.k9o project createtakes--regionand the custody modesPLATFORM_MANAGED,SKR,BYOKandHYOK.k9o function deployuploads the artifact:--artifact <file>, or--artifact-keywith--version.--tierisgatewayorsandbox.k9o audit tailis a one-off fetch, not a stream.- Signed URLs from
k9o storage objects signlast at most 900 seconds, whatever--expires-inasks for. k9o ext <slug> <verb>works for a signed-in operator only.stack,showroom,upanddoctorneed ak9o-corecheckout.ledger verifyneeds thekibo-ledger-verifybinary.- README: command reference, flags and examples rewritten from the source.
Removed
project delete,function logs,ext-admin available.me notifications,me audit-log,me data-export.org groups createanddelete,org members get,org smtp get,org audit tail.storage bucketsflags--public,--versioningand--delete-after-days.auditflags--target-kindand--target-id.policy apply --name.
Added
- Nothing.
1.2.0 — 2026-10-25
- The README now introduces the Kilimanjaro building blocks (Keep, Pulse, Gate, Kibo). No change to the public API.
1.1.1 — 2026-10-25
- Documentation links corrected: the documentation hub is https://docs.kilimanjaro.dev, with the website, platform API and console listed in a Links section. Package metadata points at the same places.
1.1.0 — 2026-10-25
- Documentation rewritten with runnable examples and expected output; internal cross-references removed from the published sources. No change to the public API.
1.0.0 — 2026-10-23
First public release. See the README for the full API overview.