kindgi queue-rules

`kindgi queue-rules`

Synopsis

kindgi queue-rules <command>

Signature

A project's queue rules — which finished runs a person is asked to correct (create / list / show / update / remove / versions / results / preview / queue-recent).

Commands

Command	Description
`kindgi queue-rules create`	Create a queue rule: which of the project’s finished runs a person is asked to correct, and how many to queue.
`kindgi queue-rules list`	List the project’s live queue rules (their latest versions), oldest first.
`kindgi queue-rules show`	Show a queue rule’s latest version.
`kindgi queue-rules update`	Change a queue rule: a new version with the given fields replaced.
`kindgi queue-rules remove`	Unregister a queue rule, so it queues nothing more.
`kindgi queue-rules versions`	List every version of a queue rule, newest first.
`kindgi queue-rules results`	A queue rule’s results since a time, by the rule’s version and the agent’s, never pooled.
`kindgi queue-rules preview`	What a rule would queue among the project’s recent runs, without queueing anything.
`kindgi queue-rules queue-recent`	Queue the rule’s matches among recent runs, to catch it up on runs that ended before it was there.

See also

`kindgi queue-rules create`

Synopsis

kindgi queue-rules create --name=<name> [--project=<id>] [--agent=<id>] [--flow=<id>] [--agent-version=<v>] [--status=completed] [--include-dry-runs] [--sample=<0-1>] [--max-open=<n>] [--group=<corrector-group-id>] [--disabled] [--queue-last=<n>] [--queue-since=<time>]

Signature

Create a queue rule: which of the project’s finished runs a person is asked to correct, and how many to queue.

Options

Option	Default	Description
`--agent <value>`	none (runs of any agent)	Match runs of this agent (repeatable). Repeatable.
`--agent-version <value>`	none (any version)	Match runs of this agent version exactly, or `pinned` for runs that got the agent's pinned version (repeatable). Repeatable.
`--disabled`	off	Create the rule disabled (it matches nothing).
`--flow <value>`	none (runs of any flow)	Match runs of this flow (repeatable). Repeatable.
`--group <value>`	none (any correction closes an item)	The corrector group whose correction closes an item. Without it, any correction closes it.
`--include-dry-runs`	off	Also match dry runs; off by default. Replays never match.
`--max-open <value>`	none (no cap)	Add nothing while this rule has this many open items. Without it, no cap.
`--name <value>`	required	A name for the rule. Required.
`--project <value>`	the workspace's default project	The project the rule is in. Without it, the workspace's default project.
`--queue-last <value>`	none (nothing is queued on create unless `--queue-last` or `--queue-since` is given)	Also queue the rule's matches among the last N finished runs, right after creating it (1 to 1000).
`--queue-since <value>`	none	Also queue the rule’s matches among runs finished at or after this time (an ISO 8601 time with a zone, or a date).
`--sample <value>`	`1` (every matching run)	The share of matching runs to queue, greater than 0 and at most 1 (default 1). The same runs every time, by run and rule id.
`--status <value>`	`completed` (only completed runs match)	Match runs by how they ended. Only `completed` is accepted — a correction needs a completed run, so `failed` and `cancelled` are refused. Repeatable.

Every command also takes the global flags.

Examples

Queue a quarter of an agent's completed runs for correction.

kindgi queue-rules create --name="refund tone" --agent=acme.refunds --sample=0.25

Create a rule and catch it up at once on the last 500 finished runs.

kindgi queue-rules create --name="all refunds" --agent=acme.refunds --queue-last=500

See also

`kindgi queue-rules list`

Synopsis

kindgi queue-rules list [--project=<id>] [--limit=<n>] [--cursor=<c>]

Signature

List the project’s live queue rules (their latest versions), oldest first.

Options

Option	Default	Description
`--cursor <value>`	none	Resume after this cursor, from the previous page's `nextCursor`.
`--limit <value>`	`25` (at most `100`)	The most rules to return.
`--project <value>`	the workspace's default project	The project the rule is in. Without it, the workspace's default project.

Every command also takes the global flags.

Examples

List a project's queue rules.

kindgi queue-rules list --project=<project-id>

See also

`kindgi queue-rules show`

Synopsis

kindgi queue-rules show <rule-id> [--project=<id>]

Signature

Show a queue rule’s latest version.

Options

Option	Default	Description
`--project <value>`	the workspace's default project	The project the rule is in. Without it, the workspace's default project.

Every command also takes the global flags.

Examples

Show a rule's latest version.

kindgi queue-rules show <rule-id>

See also

`kindgi queue-rules update`

Synopsis

kindgi queue-rules update <rule-id> [--project=<id>] [--name=<name>] [--agent=<id>] [--flow=<id>] [--agent-version=<v>] [--status=completed] [--include-dry-runs] [--sample=<0-1>] [--max-open=<n> | --clear-max-open] [--group=<id> | --clear-group] [--enable | --disable]

Signature

Change a queue rule: a new version with the given fields replaced. The match flags replace the rule’s when whole.

Options

Option	Default	Description
`--agent <value>`	unchanged (any match flag replaces `when` whole)	Match runs of this agent (repeatable). Repeatable.
`--agent-version <value>`	unchanged (any match flag replaces `when` whole)	Match runs of this agent version exactly, or `pinned` for runs that got the agent's pinned version (repeatable). Repeatable.
`--clear-group`	off	Remove the corrector group; any correction closes an item.
`--clear-max-open`	off	Remove the open-items cap.
`--disable`	off	Disable the rule.
`--enable`	off	Enable the rule.
`--flow <value>`	unchanged (any match flag replaces `when` whole)	Match runs of this flow (repeatable). Repeatable.
`--group <value>`	unchanged	A new corrector group whose correction closes an item.
`--include-dry-runs`	off	Also match dry runs; off by default. Replays never match.
`--max-open <value>`	unchanged	A new open-items cap.
`--name <value>`	unchanged	A new name for the rule.
`--project <value>`	the workspace's default project	The project the rule is in. Without it, the workspace's default project.
`--sample <value>`	unchanged	A new sample share, greater than 0 and at most 1.
`--status <value>`	unchanged (any match flag replaces `when` whole)	Match runs by how they ended. Only `completed` is accepted — a correction needs a completed run, so `failed` and `cancelled` are refused. Repeatable.

Every command also takes the global flags.

Examples

Raise a rule's open-items cap and enable it.

kindgi queue-rules update <rule-id> --max-open=50 --enable

Replace what the rule matches and drop its cap.

kindgi queue-rules update <rule-id> --agent=acme.refunds --clear-max-open

See also

`kindgi queue-rules remove`

Synopsis

kindgi queue-rules remove <rule-id> [--project=<id>]

Signature

Unregister a queue rule, so it queues nothing more. Its queued items stay.

Options

Option	Default	Description
`--project <value>`	the workspace's default project	The project the rule is in. Without it, the workspace's default project.

Every command also takes the global flags.

Examples

Unregister a rule so it queues nothing more; its queued items stay.

kindgi queue-rules remove <rule-id>

See also

`kindgi queue-rules versions`

Synopsis

kindgi queue-rules versions <rule-id> [--project=<id>] [--limit=<n>] [--cursor=<c>]

Signature

List every version of a queue rule, newest first.

Options

Option	Default	Description
`--cursor <value>`	none	Resume after this cursor, from the previous page's `nextCursor`.
`--limit <value>`	`25` (at most `100`)	The most versions to return.
`--project <value>`	the workspace's default project	The project the rule is in. Without it, the workspace's default project.

Every command also takes the global flags.

Examples

List every version of a rule, newest first.

kindgi queue-rules versions <rule-id>

See also

`kindgi queue-rules results`

Synopsis

kindgi queue-rules results <rule-id> [--project=<id>] [--since=<time>]

Signature

A queue rule’s results since a time, by the rule’s version and the agent’s, never pooled.

Options

Option	Default	Description
`--project <value>`	the workspace's default project	The project the rule is in. Without it, the workspace's default project.
`--since <value>`	none (every result)	Only runs queued (or skipped by the cap) at or after this time (an ISO 8601 time with a zone, or a date).

Every command also takes the global flags.

Examples

Show a rule's results for runs queued since a date, by the rule's version and the agent's.

kindgi queue-rules results <rule-id> --since=2026-10-01

See also

`kindgi queue-rules preview`

Synopsis

kindgi queue-rules preview [--project=<id>] [--agent=<id>] [--flow=<id>] [--agent-version=<v>] [--status=completed] [--include-dry-runs] [--sample=<0-1>] [--last=<n>] [--rule=<rule-id>]

Signature

What a rule would queue among the project’s recent runs, without queueing anything.

Options

Option	Default	Description
`--agent <value>`	none (runs of any agent)	Match runs of this agent (repeatable). Repeatable.
`--agent-version <value>`	none (any version)	Match runs of this agent version exactly, or `pinned` for runs that got the agent's pinned version (repeatable). Repeatable.
`--flow <value>`	none (runs of any flow)	Match runs of this flow (repeatable). Repeatable.
`--include-dry-runs`	off	Also match dry runs; off by default. Replays never match.
`--last <value>`	`100` (1 to 500)	How many recent runs to look at, 1 to 500 (default 100).
`--project <value>`	the workspace's default project	The project the rule is in. Without it, the workspace's default project.
`--rule <value>`	none (preview the given flags, not an existing rule)	An existing rule's id: sample as it does, so the count is exactly what it would take.
`--sample <value>`	`1` (every matching run)	The sample share to preview with, greater than 0 and at most 1.
`--status <value>`	`completed` (only completed runs match)	Match runs by how they ended. Only `completed` is accepted — a correction needs a completed run, so `failed` and `cancelled` are refused. Repeatable.

Every command also takes the global flags.

Examples

See how many of the last 200 runs a rule would queue, changing nothing.

kindgi queue-rules preview --agent=acme.refunds --last=200

Preview exactly what an existing rule would take.

kindgi queue-rules preview --rule=<rule-id>

See also

`kindgi queue-rules queue-recent`

Synopsis

kindgi queue-rules queue-recent <rule-id> [--project=<id>] [--last=<n>] [--since=<time>]

Signature

Queue the rule’s matches among recent runs, to catch it up on runs that ended before it was there. The open-items cap is not applied.

Options

Option	Default	Description
`--last <value>`	none (give `--last` and/or `--since`)	This many of the project's most recent finished runs, 1 to 1000 (newest first).
`--project <value>`	the workspace's default project	The project the rule is in. Without it, the workspace's default project.
`--since <value>`	none (give `--last` and/or `--since`)	Runs finished at or after this time (an ISO 8601 time with a zone, or a date). Give --last and/or --since.

Every command also takes the global flags.

Examples

Catch a rule up on the last 1,000 finished runs.

kindgi queue-rules queue-recent <rule-id> --last=1000

Queue its matches among runs finished on or after a date.

kindgi queue-rules queue-recent <rule-id> --since=2026-10-01

See also