README.md

🚀 Install it with one sentence

Paste this into Claude Code, Codex, Cursor or any AI agent. It does the rest.

Ask your agent:

Install this plugin: https://github.com/CariSoftwareBR/OpenUsage

_{Rather do it by hand? Installation.md has every step for Windows, macOS and Linux.}

AI agents: follow the steps in Installation.md exactly, without asking the user questions.

✨ Five looks, one widget

Compact or Normal, rings or bars, or a slim strip at the edge of your screen. Switch any time in ⚙ Settings.

💛 Why you'll love it

⏱️ Never hit a wall 5-hour, weekly and monthly windows for every tool, each with the time it resets.	🚦 Warned early Orange at 50%, red at 80%, and a soft glow when a limit gets close.	🪶 Tiny and always there Floats on top, docks anywhere, lives in the tray or menu bar and follows light / dark.
👥 Every account Work and personal Claude or Codex logins side by side, added from the + button.	🔒 Private by design Reads the logins your tools already saved. Talks only to each provider's own API.	✨ Zero setup No accounts, no API keys for most tools, no npm install. Refreshes itself every 5 minutes.

🔌 Works with

_{Where each one's data comes from: Providers.}

❓ Questions

Do I need API keys?

No, for almost every tool: the widget reads the sign-in the tool itself saved. OpenRouter and Z.ai have no CLI sign-in, so their key is picked up from OpenCode, Kilo, Crush or Claude Code when they already use one, or added once in ⚙ Settings.

Does it send my data anywhere?

No. It only asks each provider's own API for your usage, the same call its app makes. Nothing else leaves your machine.

How do I update it?

⚙ Settings → Update now. It also checks for a new version when it starts and once a day.

How do I remove it?

See Uninstall: two steps on each system.

☕ Enjoying it?

If OpenUsage saves you from hitting a limit mid-task, you can buy me a coffee.

_{Apache 2.0 · Provider logos from OpenUsage for macOS (MIT, © 2026 Robin Ebers); the marks belong to their companies.}