Use when the user wants to take a full break, step away, save their context, or says "pause", "break", "stepping away", "I need to stop". Also use when breather check-ins suggest a break and the user agrees. For quick breaks ("brb", "grabbing coffee", "need a sec"), use /breather:stretch instead.
The user is taking a break. Your job: make resuming effortless so the break feels free, not costly.
Record the break by running:
bash ${CLAUDE_PLUGIN_ROOT}/scripts/record-break.sh
Save a context snapshot to ${CLAUDE_PLUGIN_DATA:-~/.local/share/breather}/last-context.md containing:
Read the session state from ${CLAUDE_PLUGIN_DATA:-~/.local/share/breather}/current-session.json to get session duration and prompt count.
Suggest a break duration based on time since last break (or total session time if no breaks taken):
Respond briefly. No lectures. Something like:
Saved your context. You were [doing X], left off at [Y], next up is [Z].
You've been going for [duration]. [Break suggestion].
When you're back, just say "back" or /breather:back and I'll get you up to speed. For a quick break without context saving, use /breather:stretch instead.
Keep it warm but short. They're taking a break - don't make them read a wall of text first.