reflect

Run the context gathering script, then generate a structured reflection based on the output.

Step 1: Gather context

Run this command to collect Claude Code session activity. Parse the arguments the user provides to determine the time range:

npx cc-reflect $ARGUMENTS

Interpret arguments naturally:

• No args or "week" → --week
• "last week" → --week --ago 1
• "month" → --month
• "last month" → --month --ago 1
• "3 days" or "last 3 days" → --days 3
• A date range like "2026-03-01 to 2026-03-11" → --from 2026-03-01 --to 2026-03-11
• "with git" at the end of anything → append --include-git
• "stats" → --stats-only (just show stats, skip reflection)

If $ARGUMENTS is empty, default to --week.

Step 2: Generate reflection

Based on the gathered context, write a structured reflection covering:

1. Summary (3-5 sentences): Overall focus this period
2. Key Accomplishments: What was built, solved, or completed — be specific about projects, features, files
3. Research & Exploration: Topics, papers, or ideas explored
4. Tools & Patterns: Notable tools, libraries, workflows used
5. Decisions Made: Important choices and their rationale (if visible)
6. Open Threads: Unfinished work, questions to follow up on
7. Time Allocation: Which projects got the most attention? Any imbalance?
8. One-liner: A single sentence suitable for a weekly standup or advisor update

Be concrete. Reference actual project names, branches, and technical details from the logs. If something is unclear, say so rather than guessing.

Step 3: Save

Create ~/.cc-reflect/outputs/ directory if it does not exist.

Save the reflection to ~/.cc-reflect/outputs/reflection_<start>_<end>.md where start/end are the date range in YYYYMMDD format. Include a YAML frontmatter block with:

---
period: "<start> to <end>"
generated: "<current datetime>"
sessions: <count>
projects: [list of project names]
---