Zero dependencies · Runs entirely local · Free

cc-toolkit

42 free tools to understand what's really happening in your Claude Code sessions.

▸ TRY IT NOW
# Zero-install — open in browser, select ~/.claude
CC Wrapped → CC Score → CC Streak → CC Compare → Project Stats → CC Calendar → CC Roast → Health Check →
# CLI tools — zero dependencies, just run
npx cc-session-stats    # How many hours? Which projects?
npx cc-agent-load      # You vs AI time split
npx cc-personality     # Your Claude Code personality type
42
Free tools
0
Dependencies
100%
Local — no data leaves your machine
THE DATA BEHIND THIS TOOLKIT
60+ days · 3,580 sessions · 142.3 hours · 40 Ghost Days
The autonomous AI experiment that made these tools necessary.
Read the story →
cc-session-stats
How much time do you actually spend with Claude Code?
npx cc-session-stats
Total hours, active days, streaks, top projects, day-of-week patterns, health warnings.
Open → GitHub npm
NEW
cc-live
Watch your active session: tokens, burn rate, cache hit rate.
npx cc-live
Real-time session monitor. Shows input/output/cache token breakdown, estimated cost at API rates, burn rate (tokens/min), and cache efficiency. Updates every 5s.
GitHub → npm
NEW
cc-tool-mix
Which tools does Claude use most in your sessions?
npx cc-tool-mix
Break down your tool usage across all sessions: Bash, Read, Edit, Grep, Task, and more. Category breakdown (File Ops / Shell / Search / AI Agents), top-20 tools ranked, and actionable insights like "Heavy Bash user — consider Grep/Glob for searches."
Open → GitHub npm
NEW
cc-model-selector
Task complexity → Claude model recommendation.
npx cc-model-selector
Decision matrix: which tasks need Opus, Sonnet, or Haiku? Shows model pricing, cost multipliers (Opus is 5x Sonnet), and analyzes your 30-day session history to suggest optimizations.
GitHub npm
NEW
cc-skill-audit
Audit your Claude Code skills: token overhead and prune candidates.
npx cc-skill-audit
Scans ~/.claude/skills/ and session transcripts. Shows skill sizes, 30-day usage frequency, and prune candidates (large skills with zero usage). Helps keep your context window clean.
Open → GitHub npm
NEW
cc-cost-forecast
Project your Claude Code spend to month-end.
npx cc-cost-forecast
Month-end cost forecaster. Shows today/week/month spend, daily average, projected month-end total, and compares against Max plan tiers ($20/$100/$200/$400). 30-day sparkline included.
Open → GitHub npm
NEW
cc-agent-load
How much of your usage is YOU vs AI subagents?
npx cc-agent-load
Splits interactive sessions from autonomous subagent runs. Shows autonomy ratio, Ghost Days, and a GitHub-style activity calendar.
Open → GitHub npm
NEW
cc-daily-report
What did your AI do today? Ghost Day report + tweet text.
npx cc-daily-report 2026-02-09 (npm pending)
Shows AI hours, projects active, and generates a tweet-ready summary for Ghost Days — days when AI ran while you were offline. Reads proof-log for per-project detail when available.
Open → GitHub npm
NEW
cc-streak
How many days in a row? Your Claude Code streak + burnout warning.
npx cc-streak (npm pending)
Like GitHub streak but for Claude Code sessions. Shows current streak, longest streak, a 52-day activity bar, and warns when you've gone 30+ days without a rest.
Open → GitHub npm
NEW
cc-compare
This week vs last week. Are you more or less active than before?
npx cc-compare (npm pending)
Period-over-period comparison of your Claude Code activity. Shows your hours delta, AI hours delta, autonomy ratio trend, Ghost Days change, and active days — with visual bars and percentage changes.
Open → GitHub npm
NEW
cc-project-stats
Where's your Claude Code time going? Hours ranked by project.
npx cc-project-stats --days=30 (npm pending)
Breaks down your Claude Code time by project — ranked by total hours, split between interactive (you) and autonomous (AI). Filters by any time range. Uses the same session-file methodology as cc-agent-load.
Open → GitHub npm
NEW
cc-score
Your AI Productivity Score. 0–100. Shareable.
npx cc-score --share (npm pending)
Combines consistency, autonomy ratio, ghost days, session volume, and streak into a single score. S-rank = Cyborg. Includes a tweet-ready share text for your score.
Open → GitHub npm
NEW
cc-calendar
GitHub-style calendar: YOU vs AI, day by day.
npx cc-calendar (npm pending)
Contribution graph in your terminal. Two rows — cyan for YOU, yellow for AI. Ghost Days glow bright: the days AI kept working while you rested. Zero dependencies.
Open → GitHub npm
NEW
cc-ghost-log
What did your AI commit while you were gone?
npx cc-ghost-log
Shows git commits from Ghost Days — days when AI ran autonomously while you had zero interactive sessions. Your AI's work diary.
Open → GitHub npm
cc-personality
What kind of Claude Code developer are you?
npx cc-personality
Analyzes your session patterns and assigns you a developer archetype — Architect, Sprinter, Overnight Builder, and more.
Open → GitHub npm
cc-wrapped
Your Claude Code year in review. No install needed.
Open in browser → select ~/.claude
Spotify Wrapped–style visualization of your Claude Code usage. Browse your .claude folder directly — no npm required. 7 animated slides, 8 personality types, shareable stats card.
Open → GitHub npm
cc-roast
Your CLAUDE.md, brutally honest.
Open in browser → pick CLAUDE.md
Pick your CLAUDE.md file directly — no paste needed. Get a scored verdict: verbosity, strictness, complexity, thoroughness. Roasts and compliments included.
Open → GitHub npm
cc-bingo
How many of these have happened to you?
50 relatable Claude Code moments, randomized into a 5×5 bingo card. Click to mark, get bingo, share the pain.
Open → GitHub
cc-cost-check
Know what your AI costs per commit.
Interactive cost calculator. See cost per hour, per commit, per day — and compare against hiring a junior or senior developer.
Open → GitHub
cc-health-check
Is your Claude Code setup production-ready?
npx cc-health-check
20-question diagnostic across 6 dimensions — Safety, Quality, Monitoring, Recovery, Autonomy, Coordination. Instant score with actionable fixes.
Open → GitHub
NEW
cc-weekly-report
What did your AI accomplish this week?
npx cc-weekly-report
Reads your proof-log files and generates a weekly Markdown summary — sessions, hours, lines changed, top projects, daily breakdown. Ready to publish.
Open → GitHub npm
NEW
cc-standup
Your AI writes your daily standup. Paste it into Slack.
npx cc-standup --format slack (npm pending)
Reads yesterday's proof-log and generates a copy-paste-ready standup: what was worked on, time spent, lines added. Supports plain text, Slack formatting, and tweet format. Ghost Day aware.
Open → GitHub npm
NEW
cc-ai-heatmap
GitHub-style heatmap of your AI activity.
npx cc-ai-heatmap --open
Reads proof-log files and generates a beautiful standalone HTML heatmap — 52 weeks of AI sessions, color-coded by hours. Stats: total time, active days, streaks. Hover each day for details. Screenshot it.
Open → GitHub npm
NEW
claude-md-generator
Generate a custom CLAUDE.md for your project in 60 seconds.
yurukusa.github.io/claude-md-generator
Answer 5 questions about your project (type, autonomy level, language, pain points) and get a ready-to-use CLAUDE.md with decision rules, quality gates, and language-specific checks. Browser-based, zero install.
Open → GitHub
NEW
cc-review-queue
Files your AI touched that need a human look.
npx cc-review-queue --days=7 (npm pending)
Reads activity-log.jsonl and shows all files marked needs_review — hooks, config files, scripts — sorted by most recently edited. See what your AI has been touching in sensitive paths before it causes issues.
Open → GitHub npm
NEW
cc-receipt
The AI never clocks out. The receipt proves it.
npx cc-receipt (npm pending)
ASCII receipt of your AI's daily work. Shows every project, sessions, lines added — then compares AI active time to your sleep time. "AI WORKED WHILE YOU SLEPT." Screenshot it.
Open → GitHub npm
cc-audit-log
See what your Claude Code actually did. Human-readable audit trail.
npx cc-audit-log
Reads your session transcripts and shows every action: files created/modified, bash commands run, git commits made. Flags risky operations. For teams who run autonomous pipelines and want a paper trail.
Open → GitHub npm
NEW
cc-shift
See your AI's work schedule. Hour by hour, project by project.
npx cc-shift (npm pending)
Terminal bar chart of AI activity across 24 hours. Each ▓ block is ~30 minutes active. See which hours were busy, which were idle, which projects ran at 3am.
Open → GitHub npm
NEW
cc-predict
The only tool that looks forward. Forecast your month-end stats.
npx cc-predict (npm pending)
Projects month-end hours, Ghost Day count, and streak trajectory at your current pace. Uses your last 14 days as baseline. The only cc-toolkit tool that looks forward instead of back.
Open → GitHub npm
NEW
cc-peak
When are you most focused? Hour-of-day heatmap + peak window.
npx cc-peak (npm pending)
All other cc-toolkit tools answer "how much?" — cc-peak answers "when?" Shows your hour-of-day heatmap, day-of-week breakdown, and your optimal 4-hour working window. Insights: night owl vs early bird, weekend builder vs weekday focused.
GitHub npm
NEW
cc-impact
What did you actually build? Commits, lines, files across all your git repos.
npx cc-impact (npm pending)
cc-session-stats shows how many hours you spent. cc-impact shows what those hours produced: total commits, lines added/removed, files changed, ranked by most active repo. Answers "I used 140h of Claude Code — so what did I build?"
Open → GitHub npm
NEW
cc-focus
Are you spreading too thin? Weekly project scatter trends.
npx cc-focus (npm pending)
Counts how many distinct projects you used Claude Code in per week. Shows convergence (getting focused) vs divergence (spreading thin). Labels: Deep coder / Balanced builder / Project juggler / Context switcher.
Open → GitHub npm
NEW
cc-day-pattern
What day of the week do you actually code with Claude Code?
npx cc-day-pattern (npm pending)
Groups your sessions by day-of-week to show your real coding pattern. Sessions, hours, and avg session length per day. Are you a Thursday builder or a Sunday night coder?
Open → GitHub npm
NEW
cc-burnout
Burnout risk detector. cc-score rewards high usage — cc-burnout gives the opposite signal.
npx cc-burnout (npm pending)
Analyzes streak length, late-night sessions, weekend work, session escalation, and weekly ramp-up. Score 0–100 with risk signals and concrete recommendations. Sustainable coding > heroic sprints.
Open → GitHub npm
NEW
cc-monthly
Your monthly Claude Code retrospective, auto-generated in Markdown.
npx cc-monthly (npm pending)
Generates a full monthly report: hours, sessions, commits, lines added/removed, Ghost Days, and week-by-week breakdown. Pipe to a file and paste into Zenn, note, or dev.to as your monthly retro.
Open → GitHub npm
NEW
cc-collab
Are you getting better at working with Claude Code? Weekly efficiency trends.
npx cc-collab (npm pending)
Combines your CC session hours with actual git commits to compute commits-per-hour weekly. Shows whether you're improving, plateauing, or declining — with a trend chart spanning 8 weeks.
Open → GitHub npm
NEW
cc-mcp
Give Claude itself access to your usage stats. Ask in plain English.
npx @yurukusa/cc-mcp
MCP server for Claude Desktop. Ask Claude "how much have I used Claude Code this month?" or "will my streak survive?" — Claude queries your actual data and answers. The only cc-toolkit component that feeds data back into Claude during a session.
GitHub npm
NEW
cc-alert
Never lose a streak again. Get warned before it's too late.
npx @yurukusa/cc-alert
Streak risk notifier. Run as a cron job — warns you at 8pm if you haven't coded yet. Exit code 0 (safe) / 1 (at risk) / 2 (no streak). Supports --notify for OS alerts (macOS/Linux/WSL).
GitHub npm
NEW
cc-stats-badge
Put your Claude Code streak in your GitHub README.
npx @yurukusa/cc-stats-badge --out=badge.svg
Generates an SVG badge showing your streak, monthly hours, and AI autonomy ratio. Embed in your GitHub profile README. Auto-update daily with a cron job.
Open → GitHub npm
NEW
ai-life-level
What difficulty mode is your AI life on?
Open in browser → answer 7 questions
Answer 7 quick questions about your AI usage, spending, and life changes. Get your difficulty level: Easy Mode → Normal → Hard → Hardcore. Shareable result card included.
Open → GitHub
NEW
ai-cost-reality
Is your AI subscription actually worth it?
Open in browser → select your subscriptions
Bilingual (EN/JA) calculator showing what your AI stack really costs — broken down per hour, per session, per commit. Compared to hiring a developer. Based on 50 days of real data.
Open → GitHub
NEW
cc-achievements
Unlock your Claude Code milestones automatically.
Open in browser → select ~/.claude folder
20 achievements auto-detected from your session data. Volume milestones (First Steps → Half Grand), Consistency (Hat Trick → Month Strong), Ghost Days (First Ghost → Phantom), Patterns (Night Owl, Marathon), Projects (Juggler, Explorer), and Autonomy (AI Partners, AI Forward). Share what you've unlocked.
Open → GitHub
▸ COMMUNITY STATS

How do your stats compare?

Share your anonymized stats and see how you compare to other Claude Code users. No account needed — just a GitHub Gist.

📊 See community stats → npx cc-session-stats --json

Heavy Claude Code user?

If your stats show high usage, you probably want guardrails. Claude Code Production Hooks — 10 hooks + 5 templates covering 18/20 health checks. Used by power users who run autonomous pipelines.

See the Hooks Kit — $19 →