vibestats

Local AI coding stats for Claude Code and Codex CLI.

Track tokens, costs, sessions, wrapped summaries, and activity heatmaps from local usage data. Keep prompts local and only publish aggregate share pages when you choose to.

Usage reports

Break down tokens, cache usage, costs, sessions, and date windows from local Claude-compatible sources and Codex CLI history.

Wrapped summaries

Generate a year-in-review page with streaks, busiest day, model mix, total tokens, and top projects.

Activity heatmaps

Publish GitHub-style activity cards and image-ready share pages for coding sessions over time.

Quick start

Core commands

npx vibestatsnpx vibestats codexnpx vibestats --wrappednpx vibestats --activity --days 365

vibestats supports Claude-compatible local sources, OpenAI Codex CLI usage, combined reports, diagnostics, public share pages, and activity views documented in the command reference.

Privacy

Local-first by design

No prompts or responses are uploaded.
Share links contain aggregate stats, not raw conversations.
Diagnostics read local Claude files only when you request them.

Explore

DocumentationCommands, privacy model, sync plans, and self-hosting direction.WrappedAnnual summary pages for local AI coding activity and model mix.ChangelogRelease notes for CLI commands, hosted pages, shares, and model support.

Topic clusters

FeaturesClaude stats, Codex stats, wrapped, activity, sharing, privacy, diagnostics, and automation exports.CompareLocal vs cloud, wrapped vs heatmaps, daily vs monthly reports, and other reporting tradeoffs.Use casesPages for freelancers, agencies, managers, researchers, maintainers, and recurring review workflows.GuidesPractical walkthroughs for tracking, wrapping, sharing, heatmaps, costs, diagnostics, and model analysis.

FAQ

What does vibestats track?

vibestats turns local Claude Code, Codex CLI, and related session files into token, cost, session, wrapped, and activity reports.

Does vibestats upload prompts or responses?

No. vibestats is local-first and only publishes aggregate stats when you explicitly create a share page.

Which tools does vibestats support?

The current public docs cover Claude-compatible local sources, OpenAI Codex CLI usage, combined reports, wrapped summaries, diagnostics, and activity views.