claude-recap 0.1.0

Recapture what you built with Claude — conversation history analyzer and report generator

Claude Recap

Recapture what you built with Claude Code.
中文文档

---

Turn your local Claude Code conversation history into interactive dashboards, periodic reports, and AI-powered summaries — all without sending raw conversations anywhere.

Features

• Interactive Dashboard — GitHub-style activity heatmap, project breakdown, filterable session browser
• AI-Powered Summaries — Optional Claude API integration for intelligent narrative generation
• Multi-period Reports — Daily / Weekly / Monthly / Yearly
• Purpose-driven Exports — General, Academic, Job Search, Work Report modes
• Multiple Formats — Self-contained HTML, Markdown, JSON
• Cross-platform — macOS, Linux, Windows — auto-detects Claude data directory
• Privacy-first — Runs entirely on your machine; the only network call is the opt-in --ai flag

Getting Started

pip install claude-recap

# With AI summary support
pip install claude-recap[ai]
export ANTHROPIC_API_KEY=sk-ant-...

claude-recap                  # quick usage stats
claude-recap serve            # launch interactive dashboard
claude-recap report --open    # generate & open a weekly HTML report
claude-recap dashboard        # export a static dashboard file

Usage

claude-recap — Quick Stats

$ claude-recap
╭──────────────────────╮
│ Claude Recap v0.1.0  │
╰── 2026-03-10 → 04-04 ╯
  Sessions        42
  Messages      2665
  Active Days     18
  Projects        12

claude-recap serve — Interactive Dashboard

claude-recap serve [--port 6275]

Opens a local dashboard in your browser featuring an activity heatmap, messages-per-day chart, project & tool breakdown, session browser with filters, and an AI Insights button.

claude-recap report — Generate Reports

claude-recap report                                          # weekly HTML (default)
claude-recap report -p monthly --purpose academic --ai       # monthly academic + AI summary
claude-recap report --from 2026-01-01 --to 2026-03-31       # custom date range
claude-recap report -f markdown --purpose work_report        # Markdown work report

Purpose	Focus
general	Overall activity and key conversations
academic	Research activities, experiments, methodologies
job_search	Technical skills, tools used, problem complexity
work_report	Deliverables, productivity, project progress

claude-recap schedule — Automate Reports

claude-recap schedule --period weekly

Prints platform-specific cron / Task Scheduler instructions for recurring report generation.

How It Works

Claude Recap reads the JSONL conversation logs stored locally by Claude Code:

Platform	Default Location
macOS / Linux	~/.claude/
Windows	%LOCALAPPDATA%\claude\ or %APPDATA%\claude\

Override with --dir or the CLAUDE_HISTORY_DIR environment variable. All processing happens locally. The optional --ai flag sends only condensed session metadata (not full conversations) to the Claude API for summary generation.

Project Structure

src/claude_recap/
  cli.py           CLI commands (Click)
  parser.py        JSONL conversation parser
  analyzer.py      Statistics & time-series grouping
  reporter.py      Report rendering (HTML / Markdown / JSON)
  summarizer.py    AI summarization via Claude API
  server.py        Local dashboard server
templates/
  dashboard.html   Interactive dashboard template
  report.html      Report template

Development

git clone https://github.com/MazelTovy/claude-recap.git
cd claude-recap
pip install -e ".[ai]"

License

MIT