Skip to content

kindgi approvals

View as Markdown

Synopsis

Terminal window
kindgi approvals <command>
Signature

Review HITL approvals, and export their signed audit bundles.

Commands

Command Description
kindgi approvals list List the approvals your reviewer role can see.
kindgi approvals get Fetch an approval by id.
kindgi approvals complete Decide an approval.
kindgi approvals export Export a decided approval's audit bundle, signed with the deployment's export key: who decided, when, why, and its evidence.

See also

Synopsis

Terminal window
kindgi approvals list [--status=<status>[,<status>…]] [--assigned-to=me] [--order=asc|desc] [--limit=<n>] [--cursor=<c>]
Signature

List the approvals your reviewer role can see.

Options

Option Default Description
--assigned-to <value> none (all approvals your role can see) me: only the approvals assigned to you.
--cursor <value> none Resume after this cursor, from the previous page's nextCursor.
--limit <value> 25 (at most 100) The most approvals to return (default 25, at most 100).
--order <value> desc (newest first) asc (oldest first) or desc (newest first, the default).
--status <value> none (every status) Only approvals in these statuses, comma-separated (pending,assigned,in_review are the open ones): pending, assigned, in_review, approved, rejected, escalated, expired or withdrawn.

Every command also takes the global flags.

Examples

From Set approval rules for every agent:

Terminal window
pnpm exec kindgi approvals list --status=pending

From Decide an approval:

Terminal window
pnpm exec kindgi approvals list --status=assigned,in_review --assigned-to=me --order=asc

See also

Synopsis

Terminal window
kindgi approvals get <approval-id>
Signature

Fetch an approval by id.

Options

Every command also takes the global flags.

Examples

From Decide an approval:

Terminal window
pnpm exec kindgi approvals get <approval-id>

See also

Synopsis

Terminal window
kindgi approvals complete <approval-id> --decision=approve|reject|escalate|withdraw [--rationale=<text>]
Signature

Decide an approval. Approving or rejecting resumes the run that waits on it (and the flow it is a step of).

Options

Option Default Description
--decision <value> required The decision: approve, reject, escalate or withdraw. Required.
--rationale <value> none Why, recorded with the decision.

Every command also takes the global flags.

Examples

From Ask before a long conversation continues:

Terminal window
pnpm exec kindgi approvals complete <approval-id> --decision=approve
pnpm exec kindgi approvals complete ff98fdd3-5d1d-4245-bdab-2ab9971f3962 --decision=reject --rationale="Hand this one to a person"

See also

Synopsis

Terminal window
kindgi approvals export <approval-id> [--signing-key=<key-id>] [--include-messages] > bundle.json
Signature

Export a decided approval's audit bundle, signed with the deployment's export key: who decided, when, why, and its evidence. Check it with kindgi exports verify.

Options

Option Default Description
--include-messages none Add the conversation messages of the approval's run.
--signing-key <value> the deployment's active key Sign with this key (one the runtime lists). Default: the deployment's active key.

Every command also takes the global flags.

Examples

From Export signed evidence:

Terminal window
pnpm exec kindgi approvals export 0b6e3c1e-2f4f-4a51-9d0e-7a1f2c3d4e5f > approval.json

See also