Use this skill before switching coding agents, before ending a long session, before context compaction, or right after opening a repo handed off from another agent.
Saving a checkpoint
- Collect concrete session state: ·
goal: the exact user objective in one sentence. ·plan: ordered remaining/completed checklist items. ·decisions: architectural or UI trade-offs already settled so the next agent does not relitigate them. ·designRefs: Figma/Paper/Penpot URLs, node IDs, orDESIGN.md/ token paths. ·packs: active Grid packs (defaults toexonui.json). ·filesChanged: touched files (auto-merged withgit statuswhen omitted). ·openQuestions: unresolved blockers or owner decisions. ·nextStep: the single highest-leverage next action. ·targetAgent: optional destination (claude-code,codex,cursor,opencode,gemini-cli). - Call
relay_checkpointover MCP (or run/exonui:checkpoint, ornpx exonui relay checkpoint --goal "..." --next "..."). - Verify no raw credentials or API tokens appear in notes/decisions (
redactRelaySecretsstrips common token prefixes automatically, but never intentionally paste secrets).
Resuming from a checkpoint
- Run
/exonui:resume(optionally passing a specificchk_*ID) or callrelay_listfollowed byrelay_resume. - From the terminal, run
npx exonui relay --to <claude|codex|cursor|opencode|gemini> [chk_id]for a copyable handoff packet box and/exonui:resume <id>command. - Confirm git working tree parity against
filesChangedandgitBranchbefore making new edits.
Claude Code `Stop` & `PreCompact` hooks
exonui initwires.claude/settings.jsonhooks by default (--no-hooksopts out); check status withnpx exonui relay hooks statusornpx exonui doctor.exonui relay hook pre-compactpreserves earlier sessionplan,decisions,designRefs, andopenQuestions, captures transcript/git hints, and emits{ "systemMessage": "..." }so/exonui:resume <id>stays top-of-context after compaction.- See
references/packet-schema.mdfor field-by-field validation rules and hook guarantees.
Done when
- A
.exonui/relay/chk_*.jsonpacket exists with accurategoal,decisions,designRefs,filesChanged, andnextStep. .exonui/.gitignorekeepsrelay/untracked locally.- The receiving session acknowledges the checkpoint via
/exonui:resumeorrelay_resume.