kindgi schedules

Run agents and flows on a schedule: create, list, get, update, pause, resume, run-now, fires, take-ownership, unregister.

kindgi schedules list

List schedules.

kindgi schedules list [--project=<project-id>] [--status=active|paused] [--limit=<n>] [--cursor=<c>]

Flags:

• --cursor <value>: Resume after this cursor, from the previous page's nextCursor.
• --limit <value>: The most to return (default 25, at most 100).
• --project <value>: Only this project's schedules.
• --status <value>: Only active or only paused schedules.

kindgi schedules get

Fetch a schedule, with its next occurrences when asked.

kindgi schedules get <schedule-id> [--upcoming=<n>]

Flags:

• --upcoming <value>: Also show the next N times it runs (1 to 20).

kindgi schedules create

Run an agent or a flow on a schedule, or start improvement passes on an agent (--improve). Its runs act as you, checked again at every run; they're in your project's runs, naming the schedule.

kindgi schedules create --cron=<expr> (--agent=<id> [--agent-version=<v>] | --flow=<id> --flow-version=<v> | --improve=<agent-id> --project=<id> [--segment=<key:value>]…) [--timezone=<tz>] [--input=<json-or-@file>] [--project=<project-id>] [--catch-up=latest|skip] [--overlap=skip|allow] [--starting-deadline=<s>] [--label=<text>]

Flags:

• --agent <value>: Run this agent (at its live version, else the latest).
• --agent-version <value>: With --agent: run this exact version.
• --catch-up <value>: After a gap (the runtime was down): latest runs once for the latest missed time (default); skip drops them.
• --cron <value>: A cron expression: 0 7 * * 1-5 (07:00 on weekdays), @daily, …
• --flow <value>: Run this flow (with --flow-version).
• --flow-version <value>: With --flow: the flow version to run.
• --improve <value>: Start improvement passes on this agent (instead of runs), when enough new trusted "no" judgments have come in: for the project (--project), or a segment of it (--segment). --input takes the pass options, threshold and monthlyCapUsd.
• --input <value>: The input each run gets, as JSON or @<file>. An agent needs {"userMessage": "…"}; a flow takes its own input (default {}); --improve takes its pass options ({"tiers": ["settings"], "threshold": {"judgments": 5, "runs": 3, "judges": 2}, "monthlyCapUsd": 20}, the defaults).
• --label <value>: A short label.
• --overlap <value>: While the previous run is still going: skip (default) or allow another run.
• --project <value>: The schedule's project, by id (default: the tenant's Default project).
• --segment <value>: With --improve and --project: a segment of the project, key:value; repeat it in order, coarse to fine. (repeatable)
• --starting-deadline <value>: Seconds a run may start late and still count as on time (default 600).
• --timezone <value>: An IANA timezone, such as America/Toronto (default UTC).

kindgi schedules update

Change a schedule: when it runs, what it runs, or its policies.

kindgi schedules update <schedule-id> [--cron=<expr>] [--timezone=<tz>] [--input=<json-or-@file>] [--agent=<id> [--agent-version=<v>] | --flow=<id> --flow-version=<v> | --improve=<agent-id> --project=<id> [--segment=<key:value>]…] [--catch-up=…] [--overlap=…] [--starting-deadline=<s>] [--label=<text>]

Flags:

• --agent <value>: Run this agent (at its live version, else the latest).
• --agent-version <value>: With --agent: run this exact version.
• --catch-up <value>: After a gap (the runtime was down): latest runs once for the latest missed time (default); skip drops them.
• --cron <value>: A cron expression: 0 7 * * 1-5 (07:00 on weekdays), @daily, …
• --flow <value>: Run this flow (with --flow-version).
• --flow-version <value>: With --flow: the flow version to run.
• --improve <value>: Start improvement passes on this agent (instead of runs), when enough new trusted "no" judgments have come in: for the project (--project), or a segment of it (--segment). --input takes the pass options, threshold and monthlyCapUsd.
• --input <value>: The input each run gets, as JSON or @<file>. An agent needs {"userMessage": "…"}; a flow takes its own input (default {}); --improve takes its pass options ({"tiers": ["settings"], "threshold": {"judgments": 5, "runs": 3, "judges": 2}, "monthlyCapUsd": 20}, the defaults).
• --label <value>: A short label.
• --overlap <value>: While the previous run is still going: skip (default) or allow another run.
• --project <value>: With --improve: the scope's project (the schedule's own).
• --segment <value>: With --improve and --project: a segment of the project, key:value; repeat it in order, coarse to fine. (repeatable)
• --starting-deadline <value>: Seconds a run may start late and still count as on time (default 600).
• --timezone <value>: An IANA timezone, such as America/Toronto (default UTC).

kindgi schedules pause

Pause a schedule: it stops running until resumed.

kindgi schedules pause <schedule-id>

kindgi schedules resume

Resume a paused schedule from its next occurrence (the paused ones are not run).

kindgi schedules resume <schedule-id>

kindgi schedules run-now

Run a schedule now, outside its schedule (its next occurrence is unchanged).

kindgi schedules run-now <schedule-id>

kindgi schedules fires

A schedule's history, newest first: each time it fired, the run it started, or why it was skipped, refused or failed.

kindgi schedules fires <schedule-id> [--limit=<n>] [--cursor=<c>]

Flags:

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

kindgi schedules take-ownership

Become a schedule's owner, so its runs act as you (for a schedule whose owner left).

kindgi schedules take-ownership <schedule-id>

kindgi schedules unregister

Remove a schedule: it stops running.

kindgi schedules unregister <schedule-id>

Every command also takes the global flags.