cc-reflect

Weekly/monthly reflections from your Claude Code session history.

No API key needed. Claude Code is the LLM.

Install

claude plugin add Scriptwonder/cc-reflect

That's it. The SessionEnd hook installs automatically with the plugin.

Usage

CLI

npx cc-reflect --week                        # this week (default)
npx cc-reflect --month                       # this month
npx cc-reflect --days 5                      # last 5 days
npx cc-reflect --week --ago 1                # last week
npx cc-reflect --month --ago 1              # last month
npx cc-reflect --from 2026-03-01 --to 2026-03-11  # date range
npx cc-reflect --week --include-git          # include git commit history
npx cc-reflect --week --stats-only           # quick stats, no reflection

The CLI prints structured context to stdout. Pipe it into Claude or use it as input to the skills below.

Skills (inside Claude Code)

/cc-reflect:reflect                          # reflect on this week
/cc-reflect:reflect month                    # reflect on this month
/cc-reflect:reflect last week                # reflect on last week
/cc-reflect:reflect 3 days                   # reflect on last 3 days
/cc-reflect:reflect week with git            # include git history
/cc-reflect:reflect stats                    # stats only

/cc-reflect:summary                          # micro-summary of current session

What Gets Extracted

From each Claude Code session JSONL file (~/.claude/projects/):

• Your prompts — what you actually asked (the intent)
• Tools used — Read, Write, Bash, Edit, etc.
• Git branch — which branch was active at session time
• Timestamps — when each session started and how long it ran
• Project directory — which project each session belonged to

Also reads micro-summaries from ~/.claude-reflect/logs/ if they exist (higher-signal than raw log parsing).

What You Get

An 8-section reflection:

1. Summary — 3–5 sentence overview of the period
2. Key Accomplishments — what was built or solved
3. Research & Exploration — topics investigated and rabbit holes entered
4. Tools & Patterns — workflows and techniques that emerged
5. Decisions Made — choices and rationale captured
6. Open Threads — unfinished work and follow-ups
7. Time Allocation — which projects received attention
8. One-liner — for standups or advisor updates

SessionEnd Hook (Auto Micro-Summaries)

When the plugin is installed, a SessionEnd hook is registered automatically. After every Claude Code session it generates a short micro-summary and appends it to ~/.cc-reflect/logs/YYYY-MM-DD.jsonl.

These pre-digested summaries carry higher signal than raw log parsing and make reflections significantly better. No manual action required — it just runs in the background.

If you need to add it manually, the hook command is:

node ~/.claude/plugins/cc-reflect/hooks/session-end.js

Important: Extend Log Retention

Claude Code deletes session logs after 30 days by default. Add this to ~/.claude/settings.json to keep them indefinitely:

{
  "maxSessionDurationDays": 100000
}

Without this, monthly reflections will have incomplete data.

Migrating from the Python Version

If you previously used the Python-based setup:

1. Remove old slash commands: rm ~/.claude/commands/reflect.md ~/.claude/commands/summary.md
2. Remove old scripts: rm -rf ~/.claude-reflect/gather_context.py ~/.claude-reflect/hooks/session_end_hook.py
3. Install the plugin: claude plugin add Scriptwonder/cc-reflect

Your existing logs in ~/.claude-reflect/logs/ are backward compatible — the plugin reads the same format.

License

MIT