session-handofflisted

# Session Handoff Mid-session reset tool. Use **session-handoff** when context is hot, work is mid-stream, a `/clear` is needed but the conversation holds state that isn't yet on disk. ## Auto-resume Handoffs are persisted to `~/.claude/handoffs/<currentDate>-<HHMM>.md` and pinned to `~/.claude/handoffs/latest.md`. A `SessionStart` hook can surface the latest handoff at the start of a new session — see the optional setup below. ## Modes - **default** — full structured handoff. Sections render only when they have content. - **`--minimal`** — ~80-token bare-bones block: situation + next action + not-on-disk prose. Use when: - The user passes the flag explicitly, OR - Context is genuinely critical (≤25% remaining) — at that point even the regular block is too expensive. Recommend minimal in one line and let the user confirm. ## Steps ### 1. Gather evidence Two parts, parallel where independent. **Disk side — one Bash call:** ```bash mkdir -p ~/.claude/handoffs && \ echo "=== time ===" && date "+%H:%M" && \ echo "=== cwd ===" && pwd && \ echo "=== git ===" && git status --short 2>/dev/null && git log -5 --oneline 2>/dev/null && git diff --stat HEAD 2>/dev/null ``` The date (`YYYY-MM-DD`) comes from the session reminder — don't shell out for it. Only the wall-clock `HH:MM` needs `date`. **Conversation side — the cognitive step. This is the value of the handoff.** Walk this checklist explicitly. Each bucket maps to a tag or section in the block: | # | Bucket | Ren