Sign in
Authenticate Claude Code or Codex normally. Add DeepSeek and Z.AI only if you use them.
Local companion · Windows & Linux
Your AI usage.
Quietly local.
Keep Claude Code, Codex, DeepSeek, and Z.AI limits in sight from Chromium or VS Code—without sending your credentials or usage to another service.
Free and open source · MIT licensed · No telemetry
QuotaHush
Updated now
Claude42%
Session · resets in 2h 18m
Codex68%
Weekly · resets Monday
DeepSeek$8.74 balance
Z.AI86% available
One local connection
Nothing new between you and your providers.
QuotaHush reads credentials already stored by your CLI tools or keys you add locally. Clients receive normalized usage data—not your tokens.
Run Companion
A small local service queries enabled providers and binds exclusively to 127.0.0.1.
Choose a view
Use the Chromium popup, the VS Code status bar, or both. Each refreshes automatically.
Get started
Install the Companion first.
Then add whichever client fits your workflow. You only need one Companion per computer.
WindowsRecommended
- Download
QuotaHush-Setup-x64-<version>.exefrom the latest release. - Run the setup. It installs for your account without administrator privileges.
- Open the browser or VS Code extension.
Python is not required. Setup downloads no additional code, QuotaHush starts automatically when you sign in, and future stable Companion updates install automatically.
Unsigned preview: Windows may show “Unknown publisher”. Verify the release checksum or GitHub provenance before running it.
LinuxPython 3.11+
Install for your user account with one command:
curl --proto '=https' --tlsv1.2 -fsSL \
https://raw.githubusercontent.com/Wenress/QuotaHush/main/install.sh | bashUses systemd --user, verifies release checksums, updates automatically, and does not require root access.
Optional API keys
Configuration guide →
To enable DeepSeek or Z.AI on Windows, open %LOCALAPPDATA%\QuotaHush\.var.env and add DEEPSEEK_API_KEY, DEEPSEEK_PLATFORM_TOKEN, or ZAI_API_KEY. Providers without a key stay hidden.
Check the connection
Open the health endpoint after installation. A healthy Companion identifies itself as QuotaHush.
127.0.0.1:8765/health
Chromium
A popup in your toolbar
Install from the Chrome Web Store for automatic extension updates in Chrome, Edge, Brave, and other compatible Chromium browsers. A manual ZIP remains available on GitHub Releases.
Visual Studio Code
Limits beside your code
Install straight from the marketplace, or download the VSIX and choose Install from VSIX… in the Extensions view. Each provider can be set to auto, always enabled, or hidden from the Command Palette. DeepSeek and Z.AI credentials can also be entered there through a masked prompt.
Private by design
Your credentials stay on your computer.
No QuotaHush cloud. Provider requests go directly from your computer to the corresponding provider.
No prompt access. QuotaHush processes usage limits, balances, and reset times—not conversations.
No tracking. There is no project-operated analytics, advertising, telemetry, or crash reporting.
Read the privacy policy →Good to know
Common questions
Do I need every provider?
No. Configure any one provider. Missing providers do not prevent the others from working. In VS Code, run QuotaHush: Configure Tracked Providers to override automatic detection for each provider.
Does QuotaHush need Python?
Not on Windows when you use the standalone Companion. Linux and source installations require Python 3.11 or newer.
Can another device reach the Companion?
No. It listens only on 127.0.0.1, the loopback address of your computer.
How are Companion updates handled?
Installed Companions check official stable GitHub releases every six hours and verify the published SHA-256 before installing. Set QUOTAHUSH_AUTO_UPDATE=0 in the configuration file to opt out.
Why does Windows show “Unknown publisher”?
QuotaHush does not currently use a paid Authenticode certificate. Download only from the official GitHub Releases page and verify the published SHA-256 checksum or GitHub artifact attestation.