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

Command	Description
`list`	List checkpoints for a mission.
`create`	Create 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.

All subcommands honour the global --format flag (json/yaml/ndjson) — see Output Formats.

`crewship checkpoint list`

crewship checkpoint list --mission MIS-42

Flag	Type	Required	Description
`--mission`	`string`	Yes	Mission 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"

Flag	Type	Required	Description
`--mission`	`string`	Yes	Mission ID.
`--label`	`string`		Optional human-readable label.

Errors:

Exit	Meaning
409	Mission 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"

Flag	Type	Description
`--label`	`string`	Optional 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

Flag	Type	Description
`--yes`	`bool`	Skip 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.

Getting started

Sessions & identity

Agents & conversations

Crews, projects & workspaces

Missions & routines

Issues & triage

Skills & integrations

Inbox & notifications

Memory & journal

Observability

Cost & paymaster

Approvals & hooks

Configuration & system

Utilities

Checkpoint Commands

crewship checkpoint

Subcommands

`crewship checkpoint list`

`crewship checkpoint create`

`crewship checkpoint restore <id>`

`crewship checkpoint fork <id>`

`crewship checkpoint delete <id>`

​crewship checkpoint

​Subcommands

​crewship checkpoint list

​crewship checkpoint create

​crewship checkpoint restore <id>

​crewship checkpoint fork <id>

​crewship checkpoint delete <id>

​Related

crewship checkpoint

Subcommands

`crewship checkpoint list`

`crewship checkpoint create`

`crewship checkpoint restore <id>`

`crewship checkpoint fork <id>`

`crewship checkpoint delete <id>`

Related