Command reference

Every current command, plus the sync commands queued next.

Commands read local aggregated usage unless a share URL is requested. Planned sync commands will upload aggregate snapshots only after explicit setup.

quick start

Quick Start

Daily usage is the default. Source aliases select Claude-compatible usage, Codex usage, or every supported local source.

  • npx vibestatsDaily Claude-compatible usage table
  • npx vibestats claudeClaude-compatible local sources
  • npx vibestats codexOpenAI Codex CLI usage
  • npx vibestats allCombined Claude-compatible and Codex usage

usage

Usage Tables

Change aggregation, date windows, source scope, and output format without changing local data.

  • npx vibestats --monthlyMonthly aggregation
  • npx vibestats --modelModel aggregation
  • npx vibestats --sessionsPer-session breakdown
  • npx vibestats --totalTotals only
  • npx vibestats --last 7Last seven days
  • npx vibestats --since 2026-01-01 --until 2026-01-31Explicit date window
  • npx vibestats usage codex --totalCodex total usage table
  • npx vibestats usage all --dailyCombined daily usage table

sources filters

Sources And Filters

Use source flags, model-family filters, project scope, and cache controls when a positional command is not enough.

  • npx vibestats --codexCodex CLI usage through the legacy flag
  • npx vibestats --combinedCombined Claude-compatible and Codex usage
  • npx vibestats --claudeClaude model-family usage
  • npx vibestats --kimiKimi model-family usage
  • npx vibestats --minimaxMiniMax model-family usage
  • npx vibestats --dailyDaily aggregation
  • npx vibestats --compactCompact table layout
  • npx vibestats --projectCurrent project only where source metadata supports it

activity wrapped

Activity And Wrapped

Generate year-style summaries, activity heatmaps, and share links from aggregated local stats.

  • npx vibestats --wrappedAnnual wrapped summary
  • npx vibestats --wrapped --quietWrapped share URL only
  • npx vibestats --activityActivity heatmap summary
  • npx vibestats --activity --combinedCombined activity heatmap
  • npx vibestats --activity --metric sessionsActivity heatmap by sessions
  • npx vibestats --activity --days 90Activity heatmap window
  • npx vibestats --shareUsage share URL
  • npx vibestats --wrapped --no-shortDisable shortlink

limits diagnostics

Limits And Diagnostics

Inspect local limit windows and Claude local state without provider API keys.

  • npx vibestats limits claudeClaude local limit windows
  • npx vibestats limits codexCodex local limit windows
  • npx vibestats limits allCombined local limit view
  • npx vibestats --limitsUsage table with local limits
  • npx vibestats --claude-systemClaude account and app-state diagnostics
  • npx vibestats --claude-limits --jsonClaude usage-data diagnostics as JSON

config output

Config And Output

Persist output preferences, switch base URLs, and generate machine-readable stats.

  • npx vibestats --initCreate a local config file
  • npx vibestats --configShow current config
  • npx vibestats --jsonRaw JSON stats
  • npx vibestats --quietCompact totals line
  • npx vibestats --url https://vibestats.example.comUse another share host
  • npx vibestats --no-cacheBypass local persistent usage cache
  • npx vibestats --refresh-cacheRebuild local persistent usage cache

planned sync

Multi-device sync preview

These commands are reserved by the design spec. They will use anonymous tokens, read-only dashboard links, and aggregate-only uploads.

  • npx vibestats sync initCreate an anonymous sync account and first device token
  • npx vibestats syncPush aggregate daily snapshots
  • npx vibestats sync --last 30Re-sync the last thirty days
  • npx vibestats sync statusShow current sync account, device, and last run
  • npx vibestats device listList synced devices
  • npx vibestats leaderboard opt-in --handle binhexerPublish an anonymous leaderboard handle
  • npx vibestats daemon install --dailyInstall a daily scheduler for sync