Catchup

Context Catchup

Restore context after /clear - summarize recent work and project state.

Purpose

After clearing context with /clear, use this command to quickly rebuild understanding of:

• What was recently modified
• Current project state
• Outstanding TODOs and issues
• Where to resume work

Instructions

Step 1: Git History Analysis

# Recent commits (last 10)
git log --oneline -10

# Files modified in last 5 commits
git diff --stat HEAD~5 2>/dev/null || git diff --stat $(git rev-list --max-parents=0 HEAD)

# Current branch and status
git branch --show-current
git status --short

Step 2: Recent Changes Summary

# What changed today
git log --oneline --since="midnight" --author="$(git config user.name)" 2>/dev/null

# Uncommitted work
git diff --name-only
git diff --cached --name-only

Step 3: TODO/FIXME Scan

# Find outstanding work markers in recently modified files
git diff --name-only HEAD~5 2>/dev/null | head -20 | xargs grep -n "TODO\|FIXME\|XXX\|HACK" 2>/dev/null | head -30

Step 4: Project State Check

# Check for common state indicators
[ -f "package.json" ] && echo "📦 Node project: $(jq -r '.name // "unnamed"' package.json)"
[ -f "Cargo.toml" ] && echo "🦀 Rust project: $(grep '^name' Cargo.toml | head -1)"
[ -f "pyproject.toml" ] && echo "🐍 Python project"
[ -f "go.mod" ] && echo "🐹 Go project: $(head -1 go.mod | cut -d' ' -f2)"

# Active branch purpose (from branch name)
BRANCH=$(git branch --show-current)
echo "🌿 Branch: $BRANCH"

Output Format

Provide a structured summary:

---

📍 Context Restored

Project: [name from package.json/Cargo.toml/etc] Branch: [current branch] Last Activity: [time of last commit]

🔄 Recent Work (Last 5 Commits)

1. [commit message 1] - [files affected]
2. [commit message 2] - [files affected]

...

📝 Uncommitted Changes

• [list of modified files with brief description of changes]

⚠️ Outstanding TODOs

• [file:line] TODO: [description]
• [file:line] FIXME: [description]

🎯 Suggested Next Steps

Based on recent activity:

1. [Most likely next action based on patterns]
2. [Alternative focus area]

---

Usage Examples

After a long break:

/catchup

→ Full context restoration

Quick status check:

/catchup --brief

→ Just commits and uncommitted changes

Focus on specific area:

/catchup auth

→ Filter to auth-related changes

Pro Tips

1. Document before /clear: Write a brief note in a commit message or CLAUDE.md before clearing context
2. Use with Memory Bank: Combine with .claude/memory/ files for persistent state
3. Branch naming: Use descriptive branch names (e.g., feat/user-auth) to aid context restoration

$ARGUMENTS

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: FlorianBruniaux
• Source: FlorianBruniaux/claude-code-plugins
• License: MIT

Install and usage instructions live in the source repository linked above.