AiOverviewControl

Every AI quota you pay for, live in your DankBar.

A DankMaterialShell plugin that tracks quota, billing, authentication, and local usage for 40+ AI providers — locally, honestly, with no external service.

Demo · Install · Screenshots · Providers · Docs · Support · Português

🎬 Demo

_{Full-quality MP4}

✨ Why AiOverviewControl

You pay for Claude, Codex, Copilot, OpenRouter… and each one hides its quota in a different dashboard, CLI, or API. AiOverviewControl reads every provider independently and on your machine, then shows one overview.

It reports measured data when a real source exists, and says plainly when a provider is authentication-only or informational. No dashboard scraping. No invented percentages.

🚀 Features

📊 One dashboard, 40+ providers Quota, balance, analytics, and auth status side by side, with a fleet overview of average load, hottest provider, and next reset.	🎯 A pill that tells the truth Pick which quota window each provider shows in the bar, or follow the most-constrained one, as used or as remaining quota. Hover for the window and reset time. Crowded bar? Drop the names and tighten the spacing.
🤖 Deep local telemetry Claude, Codex, OpenCode, 9Router, pi, and Hermes add token, cost, model, and project analytics with a seven-day chart — read from data already on your disk. Track several Claude accounts side by side, each from its own CLAUDE_CONFIG_DIR. Claude and Codex also show credits, extra usage and limit resets, and can redeem a held reset after a confirmation.	🔔 Quota alerts Desktop notifications at 75, 85, or 95% — or per-provider thresholds — updated in place instead of spamming. Click one to open that provider's card. A DankDash card keeps the busiest providers in the overview.
🛡️ Private and resilient Secrets are never shown. One failing provider never hides the healthy ones. No paid endpoints are called to test a key.	🌍 Five languages English, Português (Brasil), Español, Deutsch, and 简体中文 — including every label the provider adapters emit.

📸 A closer look

Settings window — also available in DMS Settings → Plugins

About — version, developer, and ways to support the project

⚡ Quick start

Important

AiOverviewControl 2.0 requires DMS 2.0 or newer. On DMS 1.6, stay on 1.22.0 until your distribution ships DMS 2.0.

1. Install from the DMS plugin store:

dms plugins install aiOverviewControl

Or search for AiOverviewControl in DMS Settings → Plugins, or in the DMS plugin directory.

2. Add the widget to a DankBar section in DMS settings.

3. Sign in to the providers you use. The default set needs:

command -v bash jq curl codex claude gh
codex login && claude auth status && gh auth status

Open the ⚙ settings window to enable more providers — each one shows whether its CLI or credential is ready.

Tip

Bind the dashboard to a shortcut: dms ipc call aiOverviewControl toggle. See Usage for all commands.

Prefer a release archive or a git checkout? See Installation.

🧩 Providers

Coverage	What you get	Examples
Quota	Real usage % and reset time	Codex, Copilot, Cursor, Antigravity, OpenRouter, Z.ai, xAI, Gemini CLI
Balance	Remaining prepaid credit	Kimi, DeepSeek, Neuralwatt, Cline, Ollama Cloud, Vercel AI Gateway
Analytics	Tokens, cost, and models from local data or spend reports	Claude, 9Router, pi, Hermes, Cloudflare, Anthropic API, OpenAI API
Authentication	Credential check, no usage numbers	Mistral, Qwen, Groq, Cohere, NVIDIA
Local runtime	Local models and sessions	Ollama, Vertex AI
Informational	A link to the official usage page	Kiro, Warp, Perplexity, Amp

The full list, data sources, and credentials are in Providers.

Privacy: every credential is sent only to its own provider's official API. The plugin makes exactly two optional third-party calls, both documented with opt-outs (AIOC_NO_LITELLM=1, AIOC_NO_DOH_FALLBACK=1), and writes caches only under ${XDG_CACHE_HOME:-~/.cache}/AiOverviewControl/. See Network endpoints and the Antigravity access mechanism.

📚 Documentation

New in 2.2: Anthropic API, OpenAI API, Ollama Cloud and Vercel AI Gateway, and Gemini CLI quota — see the 2.2.0 notes. Since 2.2.1 the DankBar can show several quota windows of one provider at once (Claude 5h 45% / 7d 80%). Credits, limit resets and the DankDash card came in 2.1.0. Coming from DMS 1.6? Read the 2.0.0 upgrade guide. See cost currency and privacy, runtime module boundaries, and protected PR/release rules.

Usage	Pill, popout, cards, keyboard, IPC, history, privacy
Installation	Store, archive, and git installs; upgrades
Configuration	Every setting, environment variables, health checks
Providers	Coverage matrix and per-provider data sources
Troubleshooting	Missing cards, credentials, notifications
Architecture	Runtime flow and the adapter contract
Translations	Locales and Crowdin
Contributing	Local checks and conventions
Development gates	Tests, statement coverage, fuzzing and CI gates
Governance	Decisions, roles, code review, continuity
Roadmap	What is planned for the next year, and what is not
Security model	Security requirements and assurance case
Security policy	Reporting vulnerabilities, verifying releases
Code of conduct	Contributor Covenant 2.1
Changelog	Release history

💜 Support the project

The DMS plugin directory ranks plugins by the 👍 reactions on their registry issue. One reaction is the most useful thing you can do — it decides whether other DankMaterialShell users ever find the plugin.

Found a bug or have an idea? Open an issue.

👥 Contributors

Contributions are welcome — start with CONTRIBUTING.md.

---

_{MIT License · made with 💜 for the DankMaterialShell community}