Skip to main content

​
crewship checkpoint

Create, inspect, restore (advisory), fork, and delete mission checkpoints. A checkpoint pins a journal cursor to a human-readable label so you can return to it later. See the Cartographer guide for semantics. 
crewship checkpoint <subcommand> [flags]

​
Subcommands

CommandDescription
listList checkpoints for a mission.
createCreate a checkpoint at the current journal cursor.
restore <id>Show divergence since a checkpoint (advisory).
fork <id>Spawn a new mission from a checkpoint.
delete <id>Delete a checkpoint.

​
crewship checkpoint list

crewship checkpoint list --mission MIS-42
FlagTypeRequiredDescription
--missionstringYesMission ID to list checkpoints for.
Sample output: 
ID                        LABEL                         CURSOR                CREATED                  CREATED_BY
chk_a1b2c3d4e5f60718      green build                   j_7f3e2a1b8c9d0e12    2026-04-17T10:23:41Z     user_123
chk_b2c3d4e5f6071829      after migration               j_8a4f3b2c9d0e1234    2026-04-17T11:05:12Z     user_456

​
crewship checkpoint create

crewship checkpoint create --mission MIS-42 --label "green build"
FlagTypeRequiredDescription
--missionstringYesMission ID.
--labelstringOptional human-readable label.
Errors:
ExitMeaning
409Mission has no journal entries to anchor a checkpoint. Run some agent work first.

​
crewship checkpoint restore <id>

Advisory only. The server returns the checkpoint cursor and any journal entries that diverged since the checkpoint was made. Mission state is not mutated — use fork when you need a concrete branch. 
crewship checkpoint restore chk_a1b2c3d4e5f60718
Sample output: 
Checkpoint: chk_a1b2c3d4e5f60718
Cursor:     j_7f3e2a1b8c9d0e12
Diverged entries (3):
  - mission.status_change at j_8a4f3b2c9d0e1234
  - exec.command at j_9b5f4c3d0e1f2345
  - approval.granted at j_0c6f5d4e1f203456
Or when there’s no drift: 
Checkpoint: chk_a1b2c3d4e5f60718
Cursor:     j_7f3e2a1b8c9d0e12
No divergence since checkpoint.

​
crewship checkpoint fork <id>

Creates a new mission anchored at the checkpoint’s cursor and a matching new checkpoint in it. 
crewship checkpoint fork chk_a1b2c3d4e5f60718 --label "experiment-1"
FlagTypeDescription
--labelstringOptional label for the forked mission’s initial checkpoint.
Sample output: 
✓ Forked mission MIS-43 from checkpoint chk_a1b2c3d4e5f60718 (new checkpoint chk_new0001).

​
crewship checkpoint delete <id>

crewship checkpoint delete chk_a1b2c3d4e5f60718 --yes
FlagTypeDescription
--yesboolSkip confirmation prompt.
Gotcha: Forks that reference the deleted checkpoint via fork_of are orphaned (their reference is set to NULL). The forked missions themselves are not deleted.