QOTA App Icon
LIVE MENU BAR TELEMETRY

Your AI quotas,
but effortless.

Satisfying, real-time quota tracking for your Mac and Windows. Continuous local telemetry for Antigravity, Claude Code, and OpenAI Codex.

Free & open-source • No credit card • 100% Offline • v1.0.4

CLI QUICKSTART
git clone https://github.com/jlsonon/qota.git && cd qota && npm start
daemon.ts • Full Screen Space NSScreenSaver (Level 1001)
// QOTA: Background Session Telemetry Daemon
import { QuotaEngine, DesktopHUD } from '@qota/core';

const hud = new DesktopHUD({
  windowLevel: 'screen-saver', // Stays above full-screen IDEs
  multipliers: {
    gemini: 1,  // Flash 3.8 (1 unit)
    codex:  2,  // o3-mini (2 units)
    claude: 4,  // Sonnet 4.6 (4 units)
    opus:   8   // Opus / o1 (8 units)
  },
  watchPaths: ['~/.gemini/antigravity', '~/.claude/sessions']
});

hud.pinToAllWorkspaces();
Gemini 3.8 Flash (High)
1x • 88%
5-HOUR SPRINT LIMIT 220 / 250u
7-DAY BASELINE 97%
RESETS IN 3H 14M ZERO CLOUD RELAYS
✦ Tactile HUD: Drag to reposition • Click AGY to switch model • Click ↗ to expand

NSScreenSaverWindowLevel (1001): Floating HUD stays tactile and visible even in native macOS Full Screen spaces.

TUTORIAL • 3 EASY STEPS

See it in action.

Up and running in 60 seconds. Zero config, no API keys, and no login required.

01 INSTALL

Download & Launch

Download the universal build for macOS or Windows. QOTA attaches quietly to your system status bar and launches a local daemon.

macOS: Run Install-Qota.command
Windows: Run install.bat
Android: Grant overlay permission
Ready on first launch • No restart
02 PERSISTENCE

Anchored Floating HUD

Standard windows vanish when you go full-screen. QOTA commands Cocoa level 1001 to float permanently in your peripheral vision without stealing window focus.

Floats over full-screen VS Code & Ghostty
Live % readout in native menu bar
Hover to view resets & multipliers
Cocoa NSScreenSaverWindowLevel
03 TELEMETRY

Automatic Local Accounting

QOTA hooks directly into local session files and SQLite transcripts in ~/.gemini and ~/.claude. Prompts deduct weighted units in real-time.

Gemini Flash: 1x multiplier (1u)
OpenAI o3-mini: 2x multiplier (2u)
Claude Sonnet: 4x multiplier (4u)
100% Private • 0 bytes network egress
DESIGNED FOR CLARITY

Built with tactile precision.

Everything you need to keep continuous visibility over your sprint budgets.

All from your menu bar

Live percentage and assistant indicators rest quietly beside your clock and Wi-Fi tray, giving you instant glanceability.

Level 1001 Overlay

Never gets trapped behind native full-screen IDEs. Binds to Cocoa NSScreenSaverWindowLevel across every workspace.

Completely Private

Zero network access. No API keys, no passwords, no tokens sent to third-party servers. All session parsing is strictly local.

Proportional Multipliers

Accurately tracks consumption across different models. Flash 1x, o3-mini 2x, Sonnet 4x, Opus 8x with dual sprint and weekly rails.

Whisper-Quiet Daemon

Under 28MB resident memory footprint. Negligible CPU usage with native OS filesystem event listeners.

Universal Deployment

Universal binaries for Apple Silicon & Intel, Windows 10/11 standalone installer, and Android floating overlay.

TECHNICAL ARCHITECTURE

Model Multipliers & Hardware Specs

MODEL MULTIPLIER MATRIX

ASSISTANT / ENGINE MULTIPLIER COST / PROMPT LOCAL SOCKET
Google Antigravity (Flash 3.8) 1x 1 unit ~/.gemini/antigravity/*.jsonl
OpenAI Codex (o3-mini High) 2x 2 units ~/.codex/session.db
Anthropic Claude Code (Sonnet 4.6) 4x 4 units ~/.claude/history/*.sqlite
Anthropic Claude Code (Opus / o1) 8x 8 units ~/.claude/transcripts/

SYSTEM SPECIFICATIONS

WINDOW LEVEL Cocoa NSScreenSaverWindowLevel (1001)
WINDOWS LAYER WS_EX_TOPMOST • Layered Translucent
MEMORY FOOTPRINT ≤ 28MB RSS (Daemon mode)
NETWORK EGRESS 0 bytes • Air-gapped local parser
LICENSE MIT Open Source
FREQUENTLY ASKED QUESTIONS

Everything you need to know.

Clear answers on architecture, privacy, compatibility, and local telemetry.

What is QOTA?

QOTA is a tactile, zero-cloud desktop application and floating HUD for macOS and Windows. It provides continuous real-time visibility over your AI sprint quotas and weekly rate limits across Antigravity, Claude Code, and OpenAI Codex.

How does QOTA track quotas without cloud relays?

QOTA hooks directly into local session files and SQLite WAL databases on your drive (such as ~/.gemini/antigravity and ~/.claude/sessions). Zero API keys are needed, and 0 bytes ever leave your computer.

What is Cocoa Level 1001?

On macOS, window level 1001 (NSScreenSaverWindowLevel) pins the floating HUD above all native full-screen spaces (such as full-screen VS Code or Ghostty) without stealing window focus or interrupting keystrokes.

Which AI models and multipliers are supported?

QOTA supports Google Antigravity (Flash 3.8 at 1x), OpenAI Codex (o3-mini High at 2x), and Anthropic Claude Code (Sonnet 4.6 at 4x and Opus / o1 at 8x) with automatic proportional accounting.

Is QOTA free and open source?

Yes, QOTA is 100% free and open-source software distributed under the permissive MIT License on GitHub.

Does QOTA work on Windows and Linux?

Yes! QOTA includes universal packages for Windows 10/11 (with native System Tray integration and WS_EX_TOPMOST pinning) as well as Linux and Android overlay support.

Try it.
You'll feel the clarity.

Keep full control over your sprint budgets. Download for your OS below.

SHA256 (macOS DMG): bc0cbc2a5a5cd01d59a9adff602445e21a707a0006b1e9857164adb321f49a44