Resume Session
Load a previous session summary to continue where you left off.
Argument: $ARGUMENTS
Step 1: Find the Session File
If argument provided:
- •Full path: If $ARGUMENTS is a file path, use it directly
- •Session ID: If $ARGUMENTS looks like a session ID (e.g.,
202602051430-session-csrf-review), search for it in:- •
./.claude-sessions/(project level first) - •
~/.claude-sessions/(user level fallback)
- •
- •Partial match: If $ARGUMENTS is a partial description (e.g.,
csrf), find the most recent session containing that term
If no argument provided:
Find the latest session file:
- •Check
./.claude-sessions/first (if it exists and has files) - •Fall back to
~/.claude-sessions/ - •Sort by filename (timestamp) descending
- •Select the most recent file
Step 2: Load and Parse Session
Read the session summary file and extract:
- •
Context:
- •When the session occurred
- •What project it was for
- •What was being worked on
- •
Previous work:
- •What was accomplished
- •Files that were changed
- •Key decisions made
- •
Next steps:
- •Pending tasks from the checklist
- •Any noted follow-ups
Step 3: Present Session Context
Display the loaded session to the user:
code
RESUMING SESSION --- Session: [session-id] Date: [date from session] Project: [project name] WHAT WE WORKED ON: [Summary of previous work - keep brief, 2-4 bullet points] NEXT STEPS TO CONTINUE: [List the pending tasks/next steps from the session] FILES INVOLVED: [List key files that were being worked on] ---
Step 4: Offer to Continue
Ask the user how they'd like to proceed:
- •Continue with next steps: Start working on the first pending task
- •Review specific file: Open a file that was being worked on
- •Different direction: User has something else in mind
Step 5: List Available Sessions (if requested or on error)
If the session isn't found, or user asks to see available sessions:
- •
List all session files from both locations:
- •
./.claude-sessions/(project level) - •
~/.claude-sessions/(user level)
- •
- •
Display in a formatted list:
codeAVAILABLE SESSIONS --- Project Sessions (./.claude-sessions/): 1. 202602051430-session-csrf-review.md (Feb 5, 2026 2:30 PM) 2. 202602041000-session-research-ssrf.md (Feb 4, 2026 10:00 AM) User Sessions (~/.claude-sessions/): 1. 202602030900-session-general-cleanup.md (Feb 3, 2026 9:00 AM) ---
- •
Let user select by number or name
Important Rules
- •Project level first: Always prefer project-level sessions when in a project
- •Graceful fallback: If no sessions found, inform user and offer to start fresh
- •Validate files exist: Don't assume files in the session still exist
- •Keep context loading quick: Don't read every file mentioned, just present the summary
- •Match flexibly: Allow partial matches for session IDs and descriptions