A macOS/Windows/Linux menu-bar app that tracks your coding-agent usage. It reads the local usage logs that CLI coding agents already write on your machine — currently Claude Code, Codex, Gemini, OpenCode, OpenClaw, and Hermes — computes token counts and USD cost against a bundled pricing table, and shows the running total right in the tray — with a popup window for a closer look via charts and per-project/per-model breakdowns.
ccstats is entirely local: there is no backend server and no network access. All parsing and cost calculation happens on your machine against the bundled, static pricing table. The only outbound "network" action in the whole app is a link in the Preferences view that opens this GitHub page in your browser when you click it — nothing is ever sent automatically.
Grab the latest release for your platform from the
Releases page — .dmg for macOS, .deb/.rpm
for Linux, .exe (NSIS installer) for Windows.
Release builds are currently unsigned, so macOS will warn about an "unidentified developer" and Windows SmartScreen may flag the installer on first launch — this is expected until code signing is set up.
Prerequisites:
- pnpm (version pinned via
packageManagerinpackage.json) - Rust stable toolchain (
rustup)
On Linux, install the Tauri build dependencies first:
sudo apt-get install -y \
libwebkit2gtk-4.1-dev \
libgtk-3-dev \
libayatana-appindicator3-dev \
librsvg2-dev \
libssl-dev \
libxdo-dev \
file \
build-essential
Then:
pnpm install
pnpm tauri dev # run in dev mode
pnpm tauri build # produce an installer for the current platform
Tagged releases (vX.Y.Z) are built for macOS, Linux, and Windows via GitHub Actions — see
.github/workflows/release.yml.