name: resume-handoff description: Resume work from prior session via handoff file. Triggers "resume", "continue where we left off", "pick up where", "last session", "previous work".
Resume Session Handoff
Load state from a previous session and continue work.
Usage
bun ~/.claude/src/scripts/handoff.ts resume
Or use:
/resume-handoff
What Gets Loaded
- Previous task: What you were working on
- Progress: What was completed
- Decisions: Key choices made
- Files modified: What was changed
- Next steps: What remains
- Context: Important information
GitHub Issue Context
Before loading the local handoff, check for a linked GitHub Issue:
BRANCH=$(git branch --show-current)
ISSUE_NUM=$(echo "$BRANCH" | grep -oE '[0-9]+' | head -1)
if [[ -n "$ISSUE_NUM" ]]; then
gh issue view "$ISSUE_NUM" --comments
fi
If an issue is found, present it as the primary context — it's the shared source of truth. The local handoff supplements it with session-specific details.
Present a combined summary:
- From GitHub Issue: Title, task progress (X/Y done), latest comments
- From local handoff: Session-specific notes, open files, debug state
Available Handoffs
List handoffs for current project:
ls ~/.claude/handoffs/ | grep "$(basename $(pwd))"
Resume Options
Most Recent
/resume-handoff
Loads the most recent handoff for current project.
Specific Handoff
/resume-handoff project-name-2024-01-15-1430
Loads a specific handoff file.
List All
/resume-handoff list
Shows available handoffs.
Workflow
- Check GitHub Issue - Read linked issue for shared project context
- Load local handoff - Read session-specific state
- Review combined context - Understand where we left off
- Verify files - Check current state vs handoff
- Continue work - Pick up next steps from the issue task list
Automatic Session Start
When starting a new session, the setup automatically:
- Checks for linked GitHub Issue (reads context)
- Recalls project learnings
- Shows recent handoff if available
- Displays context from previous work