Skip to content

Latest commit

 

History

188 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AiOverviewControl mascot

AiOverviewControl

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

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

Release CI Providers Languages License

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


AiOverviewControl

🎬 Demo

✨ 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, 37 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. Hover for the window and reset time. Crowded bar? Drop the names and tighten the spacing.

🤖 Deep local telemetry
Claude, 9Router, pi, and Hermes add token, cost, model, and project analytics with a seven-day chart — read from data already on your disk.

🔔 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.

🛡️ 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
Settings window — also available in DMS Settings → Plugins
About window
About — version, developer, and ways to support the project

⚡ Quick start

1. Install from the DMS plugin store:

dms plugins install aiOverviewControl

Or search for AiOverviewControl in DMS Settings → Plugins, or in the Dank Plugins 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, Antigravity, OpenRouter, Z.ai, GLM, xAI
Balance Remaining prepaid credit Kimi, DeepSeek
Analytics Tokens, cost, and models from local data Claude, 9Router, pi, Hermes, Cloudflare
Authentication Credential check, no usage numbers Gemini, Mistral, Qwen, Groq, Cohere
Local runtime Local models and sessions Ollama, Vertex AI
Informational A link to the official usage page Cursor, Kiro, Warp, Perplexity

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

For this feature release, start with the 1.20.0 changes 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
Changelog Release history

💜 Support the project

The Dank Plugins 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.

Upvote on Dank Plugins Star on GitHub

GitHub Sponsors Ko-fi Buy Me a Coffee

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

👥 Contributors

bernardopg gtheys Luna161 arqueon goulartdev emmsixx Murat65536 gouwazi UN-9BOT SkippySteve

Contributions are welcome — start with CONTRIBUTING.md.


MIT License · made with 💜 for the DankMaterialShell community

About

Dank Material Shell widget for AI usage overview for multiple providers

Topics

Resources

Contributing

Security policy

Stars

21 stars

Watchers

2 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages