Claude Statistics
中文 29 ★
Quick Start

From download to first data in about five minutes.

Claude Statistics is a native macOS app. Install it, grant access, let it index — the core app is ready immediately, and extra providers, subscription endpoints, or integrations come from the plugin marketplace.

↓ Download the latest DMG View source
  1. 01

    Check system requirements

    Claude Statistics is a native macOS app for macOS 14 (Sonoma) and up, running on both Apple Silicon and Intel.

    • macOS 14 Sonoma or newer
    • Apple Silicon (M1+) or Intel
    • At least one AI CLI installed: Claude Code, Codex, or Gemini
  2. 02

    Download and install

    Grab the latest DMG from GitHub Releases and drag Claude Statistics.app into Applications.

    • Latest DMG → double-click to mount → drag to Applications
    • If Gatekeeper blocks it on first launch, right-click the app in Finder and choose 'Open'
    • The DMG isn't Apple-notarized, so you may need to run the command below
    xattr -cr /Applications/Claude\ Statistics.app
    Tip · Why no signing? This is an open-source project. The Apple Developer membership is $99/year. MIT license means anyone can build from source.
  3. 03

    First launch · grant access

    On first launch the app asks to read ~/.claude, ~/.codex and ~/.gemini. All parsing happens locally — nothing leaves your machine.

    • Grant Full Disk Access in System Settings (optional, for performance)
    • The app icon lives in the menu bar — that's its home
    • If it's hidden, use Bartender / Hidden Bar to surface it
  4. 04

    Wait for first parse

    Claude Statistics scans transcripts and builds a SQLite FTS index. First parse takes seconds to a minute depending on history size.

    • A progress bar appears at the top of the menu bar panel
    • Once done, the Stats tab shows the totals immediately
    • The Sessions tab folds every history session by working directory
  5. 05

    Unlock advanced features

    Each of these is one-click in-app — you don't write any commands, but you should know where they write changes.

    Enable Notch Island

    Toggle Notch Island per provider in Settings. The app auto-installs hooks at:

    • Claude → hooks field in ~/.claude/settings.json (PreToolUse, PostToolUse, Notification, Stop, PermissionRequest, etc.)
    • Codex → ~/.codex/hooks.json + [features] codex_hooks = true in ~/.codex/config.toml
    • Gemini → hooks field in ~/.gemini/settings.json (BeforeTool, AfterTool, Notification, etc.)
    Global shortcut

    ⌃⌘S brings up the panel by default. Rebind in Settings → Shortcuts.

    Switch CLI accounts

    Settings → Accounts. Save multiple accounts per provider; one-click switches the active identity — the app rewrites the auth file the CLI reads, so your next claude / codex / gemini invocation runs as the new user.

    Install plugins

    Settings → Plugins → Discover. The app fetches the claude-statistics-plugins catalog, verifies SHA-256 and manifest ID on install, then hot-loads providers, integrations, or subscription extensions.

    • Five categories: Provider / Integrations / Subscription / Share Card / Utility
    • Subscription plugins let third-party endpoints piggy-back on an existing provider's CLI and contribute quota windows, exhaust estimates, trend charts, and per-model pricing
    • The Installed tab can update, disable, uninstall, and reset trust decisions
    Export a Share Card

    Share button at the bottom of the panel → pick a theme → export PNG. 9 roles and 11 badges are auto-derived from your real usage.

  6. 06

    When something goes wrong

    Claude Statistics ships with diagnostics export — bundle logs and recent events into a single tarball for Issues.

    • Settings → Diagnostics → Export Diagnostics
    • GitHub Issues: https://github.com/sj719045032/claude-statistics/issues
    • Updates are delivered via Sparkle in the background, checked on each launch
    Tip · If Notch Island never appears, it's usually a hook that didn't install, or Codex's codex_hooks feature is still false. Re-run the toggle from Settings.
Keep exploring

Want to dive deeper into each feature?

Browse Features → Changelog