Resume work from a previous handoff session stored in .claude/handoffs
Resumes work from a previous handoff session stored in .claude/handoffs
/plugin marketplace add majesticlabs-dev/majestic-marketplace/plugin install majestic-engineer@majestic-marketplace[optional: handoff-file]haikusession/Resumes work from a previous handoff session which are stored in .claude/handoffs.
IMPORTANT: This command must be run from within a project directory, not from ~/.claude. It looks for handoffs in the project's .claude/handoffs/ directory.
The handoff folder might not exist if there are none.
Requested handoff file: $ARGUMENTS
Before listing or reading handoffs:
~/.claude)~/.claude, inform the user they need to run this command from their project directoryIf no handoff file was provided in $ARGUMENTS, list all available handoffs and use AskUserQuestion to let user select which handoff to resume.
To list handoffs, use this bash command:
if [ -d ".claude/handoffs" ]; then
echo "## Available Handoffs"
echo ""
for file in .claude/handoffs/*.md; do
if [ -f "$file" ]; then
title=$(grep -m 1 "^# " "$file" | sed 's/^# //')
basename=$(basename "$file")
echo "* \`$basename\`: $title"
fi
done
echo ""
echo "To pickup a handoff, use: /pickup <filename>"
else
echo "No handoffs directory found at .claude/handoffs"
echo "Create a handoff first using: /handoff <purpose>"
fi
If a handoff file was provided in $ARGUMENTS:
Search for matches: Look in .claude/handoffs/ for files matching the provided name. The user might have:
2025-11-04-implement-auth.md)implement-auth)auth)Handle matches:
Read the handoff: Once the correct file is identified, read it using the Read tool to get the full handoff plan.
After reading the handoff, verify the current codebase state matches what was documented:
git log --since="<handoff_date>" --oneline -- <file1> <file2> ...
Present verification summary:
## State Verification
✅ **Verified:**
- <files that exist and match>
- <patterns confirmed present>
⚠️ **Drift Detected:**
- <file> was modified on <date> (after handoff)
- <pattern> no longer found in <file>
❓ **Unable to Verify:**
- <items requiring manual confirmation>
Skip verification if:
/pickup --skip-verify <file>)After verification:
User: /pickup
Assistant: [Lists all available handoffs]
User: /pickup 2025-11-04-implement-auth.md
Assistant: [Reads the handoff and resumes work on implementing authentication]
User: /pickup auth
Assistant: Found multiple matches:
- 2025-11-04-implement-auth.md
- 2025-11-03-fix-auth-bug.md
Which handoff would you like to continue?
User: /pickup implement-auth
Assistant: Resuming handoff: Implement Authentication (2025-11-04)
## State Verification
✅ Verified:
- app/models/user.rb exists
- app/controllers/sessions_controller.rb exists
- bcrypt gem in Gemfile
⚠️ Drift Detected:
- app/models/user.rb modified 2 days after handoff
- config/routes.rb has new routes not in handoff
The handoff's "Next Step" is: Add session management.
Some files changed since this handoff. Address drift first or proceed?
User: /pickup --skip-verify implement-auth
Assistant: [Skips verification, immediately resumes from "Next Step"]