openusage

The coding agent usage dashboard you’ve been looking for.

OpenUsage auto-detects local tools/API keys and shows live quota and cost snapshots in your terminal.

Or side by side with your agent

Install

brew install janekbaraniewski/tap/openusage

Pre-built binaries for macOS, Linux, and Windows are available on the GitHub Releases page.

Or from source (Go 1.25+):

go install github.com/janekbaraniewski/openusage/cmd/openusage@latest

Building from source requires CGO (CGO_ENABLED=1) because the Cursor provider uses SQLite via mattn/go-sqlite3.

Run

openusage

Auto-detection is enabled by default and picks up local tools plus common API key env vars.

Config

You don't need to create config yourself, everything gets automatically detected. You can always overwrite/edit defaults.

Config path:

• macOS/Linux: ~/.config/openusage/settings.json
• Windows: %APPDATA%\openusage\settings.json

Minimal example:

{
  "auto_detect": true,
  "ui": {
    "refresh_interval_seconds": 30,
    "warn_threshold": 0.2,
    "crit_threshold": 0.05
  },
  "accounts": [
    {
      "id": "openai-personal",
      "provider": "openai",
      "api_key_env": "OPENAI_API_KEY",
      "probe_model": "gpt-4.1-mini"
    }
  ]
}

Full config example: configs/example_settings.json

Configured accounts are merged with auto-detected accounts, and configured ones win on conflicts.

Supported Providers

Keybindings

• Tab / Shift+Tab: switch views
• r: refresh
• /: filter
• t: cycle theme
• ?: help
• q: quit

Development

make deps
make fmt
make vet
make lint
make test
make run
make build

License

MIT