replay

Replay From Handoff

Pick up work from a previous session with full state verification and git patch restore.

Lifecycle

The handoff file is a single-use baton. Read it, verify state, restore patches, delete it.

Steps

1. Find handoff files — Search both personal and team directories. Check for own session's handoff first:

   REMEMBRALL_ROOT="${CLAUDE_PLUGIN_ROOT:-$(cat /tmp/remembrall-meta/plugin-root 2>/dev/null)}"
   source "${REMEMBRALL_ROOT}/hooks/lib.sh"
   CWD=$(pwd)
   HANDOFF_DIR=$(remembrall_handoff_dir "$CWD")
   TEAM_DIR=$(remembrall_team_handoff_dir "$CWD")
   FALLBACK_DIRS=""
   # Session ID: env var or published by hook
   OWN_SID="${CLAUDE_SESSION_ID:-$(remembrall_read_session_id "$CWD" 2>/dev/null)}"
   echo "Personal: $HANDOFF_DIR"
   echo "Team: $TEAM_DIR"
   echo "Own session: $OWN_SID"
   # Check own session first
   if [ -n "$OWN_SID" ] && [ -f "$HANDOFF_DIR/handoff-${OWN_SID}.md" ]; then
     echo "OWN SESSION HANDOFF: $HANDOFF_DIR/handoff-${OWN_SID}.md"
   fi
   # List all available
   ls -lt "$HANDOFF_DIR"/handoff-*.md "$TEAM_DIR"/handoff-*.md 2>/dev/null || echo "No handoffs found"
   # Fallback: hash lookup missed (path bug, symlink path, or running /replay from a parent dir)
   if ! compgen -G "$HANDOFF_DIR/handoff-*.md" >/dev/null; then
     FALLBACK_DIRS=$(remembrall_replay_fallback_dirs "$CWD" 2>/dev/null || true)
     if [ -n "$FALLBACK_DIRS" ]; then
       echo "Fallback dirs:"
       printf '%s\n' "$FALLBACK_DIRS"
       HANDOFF_DIR=$(printf '%s\n' "$FALLBACK_DIRS" | head -1)
       TEAM_DIR="$HANDOFF_DIR"
       if [ -n "$OWN_SID" ] && [ -f "$HANDOFF_DIR/handoff-${OWN_SID}.md" ]; then
         echo "OWN SESSION HANDOFF (fallback): $HANDOFF_DIR/handoff-${OWN_SID}.md"
       fi
       ls -lt "$HANDOFF_DIR"/handoff-*.md 2>/dev/null || true
     fi
   fi
   

   • 0 files: Tell the user: "No handoff found. Nothing to replay."
   • Own session file found: Use it directly.
   • No exact hash match, one fallback dir: Use that directory and repeat the own-session check there.
   • No exact hash match, multiple fallback dirs: List the newest handoff from each matching directory and ask the user which project/session to replay.
   • Only other sessions' files: List them with timestamps. Ask the user which one to replay before consuming — these belong to other Claude instances.
   • Multiple including own: Use own session's handoff, mention others exist.