vibestats release notes

Changelog

Every published vibestats release, backfilled from npm publish history and the local git log. Recent releases are detailed, and the launch-era micro releases are preserved instead of being collapsed away.

Latest
v1.3.8
Releases
35
Started
Dec 31, 2025
UsageWrapped
Backfill note: some older launch-day `1.0.x` releases shipped minutes apart. Those entries are still listed individually, but the notes are intentionally concise and derived from the closest matching publish window in git history.
2026
v1.3.8Mar 23, 2026

Subagent-aware stats and Claude diagnostics

Fixed the biggest stats correctness issue in the CLI by separating canonical main sessions from subagents while keeping token and cost totals intact.

  • Claude and Codex session counts now distinguish main sessions from subagents instead of inflating headline session totals.
  • Added `--claude-system` and `--claude-limits` commands for inspecting `~/.claude.json`, `~/.claude/usage-data`, cache freshness, and local rate-limit signals.
  • Refined the web share surfaces again with restored legacy usage/wrapped balance, tighter activity hover layout, and cleaner host-aware share behavior.
v1.3.7Mar 19, 2026

Web-hosted share URLs

Shifted the CLI to emit share links that stay on the vibestats web host instead of exposing backend endpoints.

  • CLI share output now prefers user-facing web URLs.
  • Prepared the ground for the later share-page visual cleanups and host redirect fixes.
v1.3.6Mar 19, 2026

Share publishing stabilisation

Cleaned up release metadata and fixed the publishing path for vibestats shares.

  • Resolved share publishing failures that could break generated share pages.
  • Tightened release metadata so the CLI and hosted share flow stayed in sync.
v1.3.5Mar 14, 2026

Activity heatmap and hosted sharing

Introduced the bigger second wave of web functionality: activity graphs, richer share artifacts, and deployment support.

  • Added the GitHub-style activity heatmap view.
  • Introduced the share artifact system and hosted share pages.
  • Added Docker deployment support for the web app.
v1.3.4Mar 6, 2026

Model naming cleanup

Polished model naming and filtering so the Claude and Codex views read like product names instead of raw internals.

  • Fixed Sonnet 4.6 to show the proper display name instead of a generic `Sonnet` label.
  • Filtered GPT-family models out of the Claude-only presentation and tightened footer copy.
v1.3.3Feb 14, 2026

Codex names in share UI

Made the hosted share pages understand and render Codex model names correctly.

  • Web share UI now shows Codex model display names instead of awkward raw identifiers.
  • Synced the CLI package metadata for the 1.3.3 line.
v1.3.2Feb 12, 2026

Release metadata sync

Small release to align package metadata and published versioning.

  • Synced package metadata to the intended release state.
v1.3.1Feb 12, 2026

Full GPT-5.x Codex variant support

Expanded Codex model detection so the CLI recognizes the broader GPT-5.3, 5.2, and 5.1 Codex variant set cleanly.

  • Added support for GPT-5.3, GPT-5.2, and GPT-5.1 Codex naming variants.
  • Reduced raw-model fallbacks for Codex users.
v1.3.0Feb 12, 2026

Rolling windows for usage views

Added a cleaner way to inspect recent usage windows directly from the CLI.

  • Added `--last N` date-window support for usage queries.
  • Started the 1.3 release line with a more flexible usage-report workflow.
v1.2.0Feb 5, 2026

New model support

Expanded model awareness for the newer Claude and Codex-era releases.

  • Added Opus 4.6 and GPT-5.3 model support.
v1.1.0Jan 24, 2026

Project and session drill-downs

Made the CLI much more useful for day-to-day debugging by adding finer filters and a stronger landing-page presentation.

  • Added `--project` and `--sessions` flags for per-project and per-chat breakdowns.
  • Added interactive visual effects to the landing pages.
v1.0.23Jan 1, 2026

Local timezone grouping

Corrected date bucketing so activity follows the user's local day instead of UTC rollover edges.

  • Switched usage grouping from UTC date boundaries to local timezone-aware grouping.
v1.0.22Jan 1, 2026

Async loading and tier sorting

Improved the CLI feel for larger histories by making loading more responsive and model ordering more intuitive.

  • Added async file loading with an animated spinner.
  • Sorted Claude models by tier priority, keeping Opus above Sonnet and Haiku.
v1.0.21Jan 1, 2026

Launch-day packaging refresh

Small republish in the middle of the loading and spinner rollout.

  • Stability release during the spinner/loading iteration cycle.
v1.0.20Jan 1, 2026

Launch-day packaging refresh

Another small republish while the CLI loading experience was being tuned.

  • Intermediate release to keep the rollout moving during rapid CLI UX iteration.
2025
v1.0.19Dec 31, 2025

TTY-safe spinner behaviour

Hardened the spinner logic so it still animates in more terminal environments.

  • Forced spinner animation regardless of TTY detection quirks.
v1.0.18Dec 31, 2025

Single-line spinner compatibility

Reduced spinner complexity to improve terminal compatibility.

  • Simplified the spinner to a single-line presentation for better compatibility.
v1.0.17Dec 31, 2025

Spinner hold-time fix

Kept the spinner visible long enough to feel intentional during quick operations.

  • Forced a full minimum spinner display interval.
v1.0.16Dec 31, 2025

Spinner dwell polish

Smoothed the loading motion so it no longer flashes by too quickly.

  • Added a minimum display time for the animated spinner.
v1.0.15Dec 31, 2025

Immediate spinner render

Removed the awkward initial pause before the loading indicator appeared.

  • Rendered the first spinner frame immediately.
v1.0.14Dec 31, 2025

Wave spinner

Introduced the first branded CLI loading animation.

  • Added the VIBESTATS wave animation spinner.
v1.0.13Dec 31, 2025

Wrapped URL polish

Cleaned up the wrapped share route and made the generated URL feel less brittle.

  • Fixed wrapped shares to use the `/wrapped/` path correctly.
  • Improved full share URL UX.
v1.0.12Dec 31, 2025

Orange share-link styling

Small presentation release focused on matching the vibestats visual language.

  • Added orange styling to the usage share link.
v1.0.11Dec 31, 2025

Raw model normalization

Reduced duplicate model rows caused by inconsistent raw IDs.

  • Normalized raw model IDs to prevent duplicate entries.
v1.0.10Dec 31, 2025

Parity fixes for usage decoding

Closed some of the biggest mismatches between vibestats, ccusage, and the web decoder.

  • Deduplicated messages to better match ccusage totals.
  • Added missing model-name mappings to the web decoder.
v1.0.9Dec 31, 2025

Historical stats-cache support

Added support for the Claude `stats-cache.json` path so older activity can be reconstructed more reliably.

  • Loaded historical usage from `stats-cache.json`.
v1.0.8Dec 31, 2025

Automatic long-range monthly view

Made longer windows easier to scan without requiring manual aggregation switches.

  • Automatically switched to monthly aggregation for long date ranges.
v1.0.7Dec 31, 2025

Codex session parsing fix

Brought Codex usage parsing in line with the real on-disk session format.

  • Fixed Codex usage parsing to match actual session files.
v1.0.6Dec 31, 2025

Share URL correctness fixes

Resolved two of the most obvious share-flow routing issues.

  • Fixed the shared usage window to show the last 31 days instead of the first 31.
  • Redirected usage shortlinks to `/` instead of `/wrapped`.
v1.0.5Dec 31, 2025

Usage sharing foundations

Started the first real sharing workflow for usage reports and tightened the web chrome around it.

  • Added the `--share` flag for usage stats.
  • Added footer links on the web pages and refreshed vibestats branding docs.
v1.0.4Dec 31, 2025

Domain and filtering cleanup

Early polish release after the rename to vibestats.

  • Updated URLs to `vibestats.wolfai.dev`.
  • Filtered synthetic models out of user-facing output.
v1.0.3Dec 31, 2025

Sparkle logo and CLI typing animation

Added some of the first branded UI details to the web experience.

  • Introduced the sparkle logo treatment and command typing animation on the landing page.
v1.0.2Dec 31, 2025

Token counting accuracy

Corrected the early CLI math so totals lined up with the reference tooling.

  • Matched token counting more closely to ccusage.
v1.0.1Dec 31, 2025

Launch UI refresh

Quick visual polish pass right after the initial release.

  • Refined the web UI with a sleeker launch look.
v1.0.0Dec 31, 2025

Initial release

The first public vibestats package, launched as Claude Code Wrapped.

  • Shipped the initial Claude Code Wrapped CLI and web experience.