Skip to content

cayu recovery

Generated from the released command parser. These commands show help only; operations run when you invoke the command without --help.

Terminal window
usage: cayu recovery [-h] {plan,execute} ...
Inspect recovery work through the canonical Cayu application factory, then
execute an exact saved plan. Planning is read-only; execution rejects stale
durable state and records per-session receipts.
positional arguments:
{plan,execute}
plan Create a bounded, secret-free recovery plan without mutating
storage.
execute Execute decisions bound to an exact saved recovery plan.
options:
-h, --help show this help message and exit
Terminal window
usage: cayu recovery plan [-h] (--session SESSION_ID | --status STATUS)
[--inactive-for-seconds INACTIVE_FOR_SECONDS]
[--limit LIMIT]
[--inspection-limit INSPECTION_LIMIT]
[--cursor CURSOR] [--format {json} | --json]
[--output FILE]
[target]
Boot the registered application once and inspect exact session, registration,
claim, model, tool, task, and interruption-cascade state. Save the JSON output
and pass it unchanged to `cayu recovery execute`.
positional arguments:
target Override project discovery with a module:factory
target.
options:
-h, --help show this help message and exit
--session SESSION_ID Inspect one exact session; repeat for more sessions.
--status STATUS Inspect one lifecycle status; repeat for more
statuses.
--inactive-for-seconds INACTIVE_FOR_SECONDS
Include only sessions inactive for at least this many
seconds.
--limit LIMIT Maximum plan items (default: 100; max: 1000).
--inspection-limit INSPECTION_LIMIT
Maximum session rows inspected (default: 1000; max:
10000).
--cursor CURSOR Continue a status-based plan page.
--format {json} Output format (default: json).
--json Emit JSON (shorthand for `--format json`).
--output, -o FILE Write output to FILE instead of stdout.
Terminal window
usage: cayu recovery execute [-h] [--target TARGET]
--execution-id EXECUTION_ID
[--decisions DECISIONS.json]
[--max-concurrency MAX_CONCURRENCY]
[--format {json} | --json] [--output FILE]
PLAN.json
Load an immutable plan, boot the same registered application once, reject
changed durable state, and emit replayable per-session receipts. No action
with an unknown external effect is selected automatically.
positional arguments:
PLAN.json
options:
-h, --help show this help message and exit
--target TARGET Override project discovery with a module:factory
target.
--execution-id EXECUTION_ID
Stable operator-supplied id; reuse it to replay an
ambiguous invocation.
--decisions DECISIONS.json
Optional JSON array of RecoveryDecision objects.
--max-concurrency MAX_CONCURRENCY
Maximum independent sessions executed concurrently
(default: 1; max: 32).
--format {json} Output format (default: json).
--json Emit JSON (shorthand for `--format json`).
--output, -o FILE Write output to FILE instead of stdout.

Getting started · Operations · Configuration