tmsjngx0/session-catchup

Catchup

Get up to speed after being away. One-page summary: what happened, where things stand, what's next.

Step 1: Determine Time Window

Parse $ARGUMENTS:

• Number (e.g., 3) → look back N days
• Empty → default 7 days
• all → 30 days

DAYS="${ARGUMENTS:-7}"

Step 2: Gather Data

Run all queries:

2a: Recent Git Activity

git log --format="%h %s" --since="$DAYS days ago" --all --no-merges 2>/dev/null | head -20

2b: Beads State

br list --status=in_progress --json 2>/dev/null
br list --status=open --json 2>/dev/null | head -20
br list --status=closed --json 2>/dev/null | head -10

2c: Memory Context

Read memory index for relevant context:

Read: ~/.claude/projects/*/memory/MEMORY.md

Scan referenced memory files that relate to active work.

2d: Uncommitted Work

git status --short 2>/dev/null
git stash list 2>/dev/null

2e: Submodule / Worktree Status

git submodule status 2>/dev/null
git worktree list 2>/dev/null

Step 3: Synthesize Summary

CATCHUP — last $DAYS days
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## What Happened

[Group commits by theme/epic. 3-5 bullet points max.]
- [theme]: [what was done] ([N commits])

## Current State

| Area | Status |
|------|--------|
| Branch | [current branch] |
| Uncommitted | [Y files / clean] |
| Stashed | [N stashes / none] |
| Worktrees | [list active worktrees] |

## Active Work

[In-progress beads tasks]
- [issue-id]: [title] — [brief status from last comment]

## Ready to Pick Up

[Top 3 ready tasks by priority]
- [issue-id]: [title] (P[N])

## Recommended Next

→ [Single most impactful action, with rationale]

Rules:

• One screen max. Quick orientation, not a report.
• Group related commits — don't list individually
• "Recommended Next" must be specific: "Close nzas.2.2 — event-sourcing engine 80% done" not "continue working"
• If nothing happened in window: "No activity in the last N days."
• Highlight anomalies: uncommitted work, detached HEAD, dirty submodules

Step 4: Offer Actions

Quick actions:
- /next          — claim or resume a task
- /recall [topic] — search past sessions
- /handoff       — generate handoff for someone else

Notes

• Read-only — never modifies state
• Skip sections gracefully if beads/memory not initialized
• Prefer brevity over completeness