Aiusage

AIUsage

  Local-first usage tracker for AI coding assistants.

  Website ·
  Docs ·
  Leaderboard ·
  English | 中文

Track tokens, cost, sessions, models, projects, tool calls, and quota pressure across 20+ AI coding tools in one local dashboard. Local use needs no account, sends no telemetry, and does not require cloud sync.

Highlights

- One local dashboard for tokens, cost, sessions, models, projects, tool calls, and quotas.
- Broad parser support for Claude Code, Codex, OpenCode, Cursor, Copilot, Gemini CLI, and more.
- Optional sync through GitHub, S3, R2, or MinIO.
- Optional public leaderboard with signed aggregate uploads only.
- Desktop widget for a tray/menu-bar glance at recent usage.
- Private by default: local parsing and local dashboards do not upload your prompts, completions, source code, or file paths.

Quick Start

Requirements: Node.js 20+ on macOS, Linux, or Windows.

Open http://127.0.0.1:3847 to use the dashboard. serve starts the local web UI immediately and parses local logs in the background during startup.

Prefer pnpm:

Use Docker:

The container binds to 0.0.0.0 so it is reachable from outside Docker, and startup is refused unless AIUSAGE_DASHBOARD_PASSWORD is set to a non-empty value; replace change-me with your own password. Docker persists AIUsage data with the ~/.aiusage mount. To parse AI tool logs from the host, also mount each source log directory and configure the matching AIUSAGE_*_PATH variable. See the Docker docs.

Common Commands

Full CLI reference: aiusage.jtanx.com/docs#cli-reference.

Supported Tools

Default paths and environment variable overrides are documented in Data Sources and Source Env Vars.

Dashboard Password

The dashboard binds to 127.0.0.1 by default. Use aiusage serve --host ::1 for IPv6 loopback. Local…