/resume

Load the session state from .claude/session-state.md and restore context from a previous checkpoint.

Workflow

Step 1: Find the State File

Use Glob to locate .claude/session-state.md in the project root.

• If it does not exist: Inform the user that no checkpoint was found. Suggest running /checkpoint to create one.
• If it exists: Proceed to Step 2.

Step 2: Read and Parse the State File

Read .claude/session-state.md in full. Parse each section:

• Last Updated — When the checkpoint was taken
• Session Goal — The overarching objective
• Decisions Made — All recorded decisions and their rationale
• Issues Found — Open and resolved issues with severity
• Work Completed — What has been finished so far
• Current Task — What was in progress at checkpoint time
• Next Steps — Priority-ordered upcoming work
• Key Context — Non-obvious information to keep in mind
• User Notes — Any notes the user saved

Step 3: Present Summary

Display a structured summary to the user:

## Session Restored

**Goal:** <session goal>
**Last checkpoint:** <timestamp>

**Current task:** <current task summary>

**Open issues:** <count> (<critical count> critical, <warning count> warning)

**Next steps:**
1. <top priority>
2. <second priority>
3. <third priority>

**Key context to remember:**
- <most important context items>

Step 4: Incorporate into Context

Internalize the full state file contents. From this point forward:

• Treat all recorded decisions as established — do not re-debate them unless the user asks
• Be aware of all open issues and their severity
• Continue from where the Current Task left off
• Follow the Next Steps priority order
• Keep all Key Context items in mind

Step 5: Offer to Continue

Ask the user:

• "Would you like to continue with <current task>, or move on to the next step: <next step 1>?"
• If there are critical issues, flag them: "Note: there are <N> critical issues that may need attention first."

Important

This command is read-only. It does not modify the state file. Only /checkpoint and the PreCompact hook write to the state file.