Open source · MIT License · Terminal first

Know your AI limits before they stop your work.

aimeter puts usage, quota windows and reset times for your AI providers in one terminal dashboard. One static binary. No account, telemetry or runtime dependencies.

Install aimeter View on GitHub 
brew install cookiebinary1/tap/aimeter
go install github.com/cookiebinary1/aimeter@latest
curl -fsSL https://raw.githubusercontent.com/cookiebinary1/aimeter/main/install.sh | sh

macOS / Linux · No Go or Homebrew required 

go install github.com/cookiebinary1/aimeter@latest

PowerShell or Command Prompt · Requires Go 1.25+

macOS / Linux / Windows binaries available on GitHub Releases

aimeterActual terminal output
Real aimeter terminal dashboard showing quota windows across AI providers
Full dashboardView full screenshot

7 built-in providers

90 s auto-refresh

CLI + JSON output

MIT licensed

01 / A clearer picture

One view for the limits that matter.

See where you stand across providers without jumping between billing and usage pages.

Quota windows, at a glance

Usage bars, remaining balances and reset times share one terminal view.

Automatic refreshEvery 90 seconds
On your termsr refresh · q quit

Built for scripts too

Use Markdown tables or structured JSON in logs, cron jobs and AI agents.

-plainMarkdown tables
-jsonStructured output
Explore the output

02 / Your providers

Your stack, in one terminal.

  • Anthropic
  • OpenAI Codex
  • Z.AI
  • MiniMax
  • OpenRouter
  • ElevenLabs
  • Meshy

Need another service? Add a custom JSON endpoint in credentials.json

Available metrics depend on the provider API.

03 / Up and running

Install in one command.

One static binary.
No runtime dependencies.

macOS or Linux · Requires Homebrew

brew install cookiebinary1/tap/aimeter

macOS, Linux or Windows · Requires Go 1.25 or later 

go install github.com/cookiebinary1/aimeter@latest

Make sure your Go binary directory is on your PATH.

macOS / Linux · amd64 / arm64 · Requires curl, tar and sha256sum or shasum 

curl -fsSL https://raw.githubusercontent.com/cookiebinary1/aimeter/main/install.sh | sh

Downloads the latest release, verifies its SHA-256 checksum and installs to ~/.local/bin. Add that directory to your PATH if needed, then run aimeter. No sudo, Go or Homebrew required. Rerun to update.

Inspect the installer or choose a version or install directory.

Windows · Download the ready-to-run release:

Download Windows x64 Download Windows ARM64

Extract the ZIP and run aimeter.exe. These links download version 0.1.1 directly.

Or build it with Go · PowerShell or Command Prompt · Go 1.25+ 

go install github.com/cookiebinary1/aimeter@latest

Install Go for Windows first and reopen your terminal. Make sure %USERPROFILE%\go\bin is on your PATH.

Requires Git and Go 1.25 or later · Commands for a macOS / Linux shell 

git clone https://github.com/cookiebinary1/aimeter
cd aimeter
go build -o aimeter .
./aimeter

macOS, Linux and Windows · amd64 and arm64 · No Go toolchain required

Choose a release binary

Download and extract the archive for your OS and architecture. Run aimeter from your terminal, or .\aimeter.exe in Windows PowerShell.

Next steps

aimeter reads credentials already available on your machine. Add API keys via environment variables or ~/.config/aimeter/credentials.json when needed.

Read configuration guide
aimeterInteractive dashboard
aimeter -show-credsCheck where credentials were found
aimeter -plainMarkdown table
aimeter -jsonStructured output

Also available: -once renders the dashboard once; -version prints the version. Without an interactive terminal, running aimeter with no flags produces a Markdown table.

04 / Beyond the dashboard

From terminal view to automation input.

The same provider data. In a format your next tool can use.

aimeter -plain

Example output · Markdown

| Provider     | Plan     | Window | Used | Detail | Resets in |
| ------------ | -------- | ------ | ---- | ------ | --------- |
| Anthropic    |          | 5h     | 56%  |        | 46m       |
| OpenAI Codex | prolite  | 7d     | 14%  |        | 5d 17h    |

Readable in logs, issues and agent prompts.

aimeter -json

Example output · JSON

[
  {
    "provider": "Anthropic",
    "gauges": [
      { "label": "5h", "used": 56,
        "resets_in": "46m", "window": "5h0m0s" }
    ]
  }
]

Structured fields for scripts and health checks.

Make it part of your workflow.

Fail a health check when any provider reports an error.

Requires jq 
aimeter -json | jq -e '[.[] | select(.error != null)] | length == 0' >/dev/null

Before a long AI job, check the relevant quota window and defer the job if there is not enough headroom.

05 / Local by design

Credentials stay on your machine.

aimeter reads credentials from local sources and sends them only to the corresponding provider API over HTTPS. It does not run a hosted account or collect telemetry.

Read the security notes
  1. 01
    Environment / config / native storesIncluding macOS Keychain, Claude Code and Codex CLI stores
  2. 02
    aimeterReads local credentials
  3. 03
    Provider APISent only to the corresponding service over HTTPS

-show-creds lists sources, never secret values. 

chmod 600 ~/.config/aimeter/credentials.json

Made to be yours

Open source.
Built for the terminal.

Contributors are welcome. Want another usage meter, a new provider or a better workflow? Open an issue to share your idea or ask how to help, or contribute a pull request on GitHub.
aimeter is released under the MIT License.

View source Contribute on GitHubShare an ideaMIT License

Get in touch

Contact

Questions, ideas or feedback? Leave a message here.