acusage 0:readme* 1:install 2:privacy install commands privacy docs github
open source · MIT · offline

Know which account spent your AI tokens.

acusage reads the local logs of Claude Code, Codex, Antigravity and Gemini CLI and reports tokens and API value per account, agent, model, day and session. One Rust binary. No network, no writes.

npx acusage
or install the binary (macOS, Linux)
curl -LsSf https://github.com/viewtools-app/acusage/releases/latest/download/acusage-installer.sh | sh
~ zsh
acusage daily --compact
╭──────────────────────────────────────────╮
│ ACUsage · Daily Token Usage Report       │
│                                          │
│ Period    9 Nov 2026 to 10 Nov 2026      │
│ Accounts  3                              │
│ Agents    Claude Code, Codex             │
│                    acusage.viewtools.app │
╰──────────────────────────────────────────╯
┌────────────┬───────────────┬────────────────┬───────────────┬───────────┬─────────┬─────────────────┐
│ Date       │ Agent         │ Account        │ Models        │ Input     │ Output  │ API Value (USD) │
├────────────┼───────────────┼────────────────┼───────────────┼───────────┼─────────┼─────────────────┤
│ 2026-11-09 │ All           │                │               │ 1,912,407 │ 402,118 │          $48.10 │
├────────────┼───────────────┼────────────────┼───────────────┼───────────┼─────────┼─────────────────┤
│            │ - Claude Code │ me (Personal)  │ - opus-5-5    │ 1,204,331 │ 251,092 │          $31.75 │
├────────────┼───────────────┼────────────────┼───────────────┼───────────┼─────────┼─────────────────┤
│            │ - Codex       │ me (Work)      │ - gpt-6.1-sol │   708,076 │ 151,026 │          $16.35 │
├────────────┼───────────────┼────────────────┼───────────────┼───────────┼─────────┼─────────────────┤
│ 2026-11-10 │ All           │                │               │   864,210 │ 190,334 │          $19.40 │
├────────────┼───────────────┼────────────────┼───────────────┼───────────┼─────────┼─────────────────┤
│            │ - Claude Code │ team (Example) │ - sonnet-5-5  │   864,210 │ 190,334 │          $19.40 │
├────────────┼───────────────┼────────────────┼───────────────┼───────────┼─────────┼─────────────────┤
│ Total      │               │                │               │ 2,776,617 │ 592,452 │          $67.50 │
└────────────┴───────────────┴────────────────┴───────────────┴───────────┴─────────┴─────────────────┘
API Value = what this usage would cost at API prices; subscriptions are not billed per token.
illustrative numbers; the table format is the real one
01 why
per-account--account

Personal, work, a second subscription. Every request is tied to the account that made it.

windowsblocks · limits

5-hour billing blocks with burn rate and projection, and Codex rate-limit windows.

scriptable--json

Stable JSON output for your own dashboards, scripts and status bars.

~100ms
daily --json over ~630 MB of logs, MacBook
0
network connections
0
files written
02 commands
acusage --help
Usage report for Claude Code, Codex, Antigravity and Gemini CLI logs

Usage: acusage [OPTIONS] [COMMAND]

Commands:
  daily     Usage per day (default)
  weekly    Usage per ISO week (Monday start)
  monthly   Usage per month
  session   One row per session
  blocks    Billing blocks per account (5-hour windows)
  accounts  Every account seen
  limits    Codex rate-limit windows
  ...
full reference: docs/usage.md
03 privacy

Try it in five seconds.

npx acusage
reads your local logs, prints a table, touches nothing