Checkpoints & notes
Checkpoints and dumps are private to you — never posted to a team. A checkpoint saves your working state (with git context) so you, or your coding agent, can reload it later. A dump is a quick scratch note.
Checkpoints & resume
Run a checkpoint at a context switch — it has no daily cap.
stn checkpoint "what you're working on"
stn checkpoint "..." --reason "why" --next "the next step"
stn checkpoint "..." --team TEAM --status parked # active | parked | done
stn checkpoint --draft # AI-draft the focus from git; you edit & confirm
By default a checkpoint captures your local git context (branch, HEAD, dirty state, recent commits) — all local, no network, with credentials stripped from the remote URL. Opt into extra context sources:
stn checkpoint "..." --no-context # skip the git capture entirely
stn checkpoint "..." --shell # attach recent shell history (opt-in, secret-redacted)
stn checkpoint "..." --ai-session PATH # attach the prompts from an AI session log
stn checkpoint "..." --github # attach your GitHub review/commit context via local `gh` (network)
stn checkpoint "..." --editor # attach active/open files from a VSCode-style editor extension
Reload it later:
stn resume # last checkpoint: focus, why, next step, open blockers
stn resume --team TEAM # scope to one team
stn resume --json # machine-readable output
stn resume --offline # read the last local checkpoint mirror (no network)
stn resume --no-github # don't also query your `gh` review queue
stn resume shows your last checkpoint, the blockers other people have put on you,
your own open blocks, and — when gh is installed — the PRs awaiting your review, with
any linked GitHub PRs resolved to their live title and state. List past checkpoints with:
stn checkpoints # most recent first
stn checkpoints --team TEAM --since YYYY-MM-DD
Generates. Every checkpoint is mirrored to ~/.stndp/checkpoints/
(by id, plus a latest-*.json per team) so resume --offline works with no
network.
Private notes (dumps)
stn dump "migrated the user table" # save a private note — only you can see it
stn dump # prompt for the note
stn dump --show # your recent notes
stn dump --show --from 2026-06-01 # notes since a date
Dumps are scratch notes for yourself: a contextless checkpoint with no git snapshot. Capture
progress through the day — messy is fine — then review with --show when standup time
comes and frame your actual stn push however you
like. Dumps never appear in any team feed.