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

macOS (Homebrew, recommended)

brew install janekbaraniewski/tap/openusage

All platforms (quick install script)

Downloads the latest release artifact for your platform and installs openusage.

curl -fsSL https://github.com/janekbaraniewski/openusage/releases/latest/download/install.sh | bash

On Windows, run the command in Git Bash, MSYS2, or Cygwin.

From source (Go 1.25+)

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

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