Skip to content
Kindgi

kindgi runs

Manage kernel runs — the single execution primitive.

kindgi runs list

Section titled “kindgi runs list”

List runs (paginated).

Terminal window
kindgi runs list [--limit=<n>] [--cursor=<c>]

Flags:

  • --cursor <value>: Resume after this cursor, from the previous page's nextCursor.
  • --limit <value>: The most runs to return (default 25, at most 100).

kindgi runs get

Section titled “kindgi runs get”

Fetch a run snapshot by id.

Terminal window
kindgi runs get <run-id>

kindgi runs cancel

Section titled “kindgi runs cancel”

Request cancellation of a run.

Terminal window
kindgi runs cancel <run-id>

kindgi runs journal

Section titled “kindgi runs journal”

Read the durable journal for a run.

Terminal window
kindgi runs journal <run-id> [--since=<seq>] [--limit=<n>] [--cursor=<c>]

Flags:

  • --cursor <value>: Resume after this cursor. Not applied yet: the API returns the whole journal.
  • --limit <value>: The most entries to return. Not applied yet: the API returns the whole journal.
  • --since <value>: Only the entries after this sequence number.

kindgi runs stream

Section titled “kindgi runs stream”

Subscribe to a run event stream (SSE).

Terminal window
kindgi runs stream <run-id>

kindgi runs start

Section titled “kindgi runs start”

Start a run for an agent or flow. Waits for it to finish; with --no-wait a flow run prints as soon as it exists and finishes in the background (follow it with runs get / runs stream). An agent run always answers when its turn ends. --dry-run runs only read-only tools.

Terminal window
kindgi runs start (--agent=<agent-id> | --flow=<flow-id>) --input=<json-or-@file> [--no-wait] [--dry-run] [--idempotency-key=<key>]

Flags:

  • --agent <value>: The agent to run, by id (&lt;pack&gt;.&lt;agent&gt;). Give --agent or --flow.
  • --dry-run: Run only the tools declared read-only (mutating: false); an agent turn skips its model call.
  • --flow <value>: The flow to run, by id. Give --flow or --agent, not both.
  • --idempotency-key <value>: A retry with the same key returns the run the first call started.
  • --input <value>: The run's input as JSON, or @&lt;file&gt; to read it from a file. Required.
  • --no-wait: Return a flow run as soon as it exists; follow it with kindgi runs get. An agent run still waits for its turn.

kindgi runs resume

Section titled “kindgi runs resume”

Resume a suspended run at a waitpoint.

Terminal window
kindgi runs resume <run-id> --waitpoint=<id> --value=<json-or-@file>

Flags:

  • --value <value>: The value to resume with, as JSON or @&lt;file&gt; to read it from a file. Required.
  • --waitpoint <value>: The waitpoint to complete, by id. Required.

Every command also takes the global flags.