Skip to main content
DocumentationLibraryReference
On this page

Kater CLI Projects and timelines snapshot

kater snapshot draft

Run the app's queries once for its snapshot, and print what changed.

Kater runs each query the app’s pages name once, as you, in its worker, then checks each figure for the newest complete week against the week before. This waits up to 30 seconds for the run. It then prints the packet to write the words from, or says to stop when there is no new week. Only the owner of a workflow that writes the app drafts it.

Examples

Terminal window
# Run the app's queries once for its snapshot, and print what changed
kater snapshot draft <app>

Arguments

ArgumentDescription
<app>The app’s id, such as app_129abe379bbf43b5a7012c252157e634.

Options

OptionDescription
--by-handA run a person asked for, not the schedule’s.
--run <run>Read this run, which an earlier draft started, such as run_0123….
--anywayWith --run: write a snapshot of a run that found no new week, once the person says so.
--week <week>A backfill: the week to read as the newest, by its Monday, such as 2026-09-28.

It also takes the global options --json and --help.

See also