claude-stats

Calculate Claude Code usage statistics from the vibe-check database.

1|1|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/wanderingstan/vibe-check --skill claude-stats
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-stats
Source: https://github.com/wanderingstan/vibe-check/tree/main/skills/vibe-check-stats
Command: npx skills add https://github.com/wanderingstan/vibe-check --skill claude-stats

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly quantify Claude Code usage from your vibe-check database to answer questions about how you use Claude over time and across projects.

Core Features & Use Cases

  • Overview statistics: total events, sessions, and active days, with a time-filterable view.
  • Per-event-type breakdown: category breakdown by tool usage and activity.
  • Top repositories and recent activity: identify most-used projects and recent trends.
  • Integration with MCP tools: uses vibe_stats under MCP to fetch data and return formatted results.

Quick Start

Ask Claude to show my Claude Code usage stats for the last 7 days.

Frequently Asked Questions about claude-stats

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track Claude Code usage statistics from my database?

You can track Claude Code usage statistics by querying the vibe-check database with time-range and repository filters to return an overview, per-event-type breakdown, top repositories, and daily activity. The tool builds correct vibe_stats parameters under MCP to fetch and format results.

Can I filter Claude Code usage analytics by specific repositories and time ranges?

Yes, Claude Code usage analytics support time-range filtering by days and repository filtering. This allows you to isolate specific project data and review usage trends over defined periods, returning formatted daily activity and event breakdowns.

What insights can I get from Claude Code usage analytics?

Claude Code usage analytics provide total events, sessions, active days, per-event-type breakdowns by tool usage, top repositories, and recent activity trends. These insights help quantify how you use Claude over time and across projects.

How do I retrieve Claude Code stats using MCP tools?

To retrieve Claude Code stats, the tool uses vibe_stats under MCP to fetch data from the vibe-check database. It automatically builds the correct parameters, handles missing data gracefully, and presents the usage results in a consistent, readable format.

Does the vibe-check database need specific setup before calculating usage stats?

The vibe-check database must be populated with Claude Code activity events to calculate usage stats. The tool gracefully handles missing data, but an active database connection via MCP is required to fetch and return the formatted statistical overview.