Skip to content

About

Desktop app for viewing Claude Code usage stats

Resources

Stars

3 stars

Watchers

0 watching

Forks

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

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages