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 and QuotaHush starts automatically when you sign in.
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 a systemd --user service 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
Download the Chromium ZIP, extract it, then use Load unpacked from Chrome, Edge, or Brave's extension page.
Get the Chromium extension →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.
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.
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.
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.