Skip to content

shaunchurch/claude-stats

Repository files navigation

Claude Stats

Desktop app for viewing Claude Code usage statistics.

Claude Stats Screenshot

How It Works

Claude Code stores usage data locally on your machine in ~/.claude/. This app reads those files directly - no data is sent anywhere. Everything stays on your computer.

  • Token usage comes from JSONL files in ~/.claude/projects/
  • Activity stats come from ~/.claude/stats-cache.json
  • The optional Limits feature fetches from claude.ai (your browser session)

Features

  • Daily Usage: Token breakdown (input, output, cache write/read), message counts, estimated costs
  • Sessions: Per-conversation usage with topics and project filtering
  • Activity: Message/session/tool call trends from ~/.claude/stats-cache.json
  • Limits (optional): Real-time usage limits from claude.ai API

Requirements

Development

# Install dependencies
npm install

# Run dev server
npm run tauri dev

# Build for production
npm run tauri build

Data Sources

All data is read locally from your machine:

Data Source
Token usage ~/.claude/projects/*/*.jsonl
Activity stats ~/.claude/stats-cache.json
Usage limits claude.ai API (requires session cookie)

Limits Tab (Optional)

To fetch real-time usage limits from claude.ai:

  1. Open claude.ai in your browser
  2. Open DevTools > Network tab
  3. Find any API request and copy:
    • sessionKey from cookies
    • org_id from request URL (e.g., org_xxx)
  4. Enter these in the Limits tab

Tech Stack

License

MIT

About

Desktop app for viewing Claude Code usage stats

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •