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();
88
Flash 3.8
1 hour, 31 minutes
✦ Top Notch HUD: Hover to expand full telemetry cards • Click to lock open

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.

LEVEL 1001 • ALWAYS ON TOP

Cocoa NSScreenSaver Window Level

Never trapped behind full-screen IDEs. Binds to level 1001 so limits stay in your peripheral vision.

STATUS TRAY

All from your menu bar

Live percentage and assistant indicators rest quietly beside your clock for instant, at-a-glance visibility.

ZERO EGRESS

Completely Private

Zero network calls or API keys. All session accounting parses strictly on your local disk.

4 MULTIPLIERS

Proportional Multipliers

Accurately tracks consumption across model tiers with dual sprint and weekly rails.

1x Flash 2x o3-mini 4x Sonnet 8x Opus
< 28MB RAM

Whisper-Quiet Daemon

Under 28MB resident RAM and near-zero CPU using native OS filesystem event listeners.

Universal Platform Distribution

Standalone native packages compiled without bloat. Ready to run out of the box with zero runtime dependencies.

macOS Universal (Apple Silicon & Intel) Windows 10 / 11 (64-bit) 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?

A zero-cloud desktop HUD and menu bar pill tracking real-time AI sprint and weekly rate limits across Antigravity, Claude Code, and Codex.

How does QOTA track quotas without cloud relays?

Reads local session files and SQLite WAL databases directly on your drive. Zero API keys required; zero bytes leave your machine.

What is Cocoa Level 1001?

Level 1001 (NSScreenSaverWindowLevel) pins the HUD above full-screen IDEs and spaces without stealing window focus or keystrokes.

Which AI models and multipliers are supported?

Antigravity (Flash 1x), OpenAI Codex (o3-mini 2x), and Claude Code (Sonnet 4x, Opus 8x) with automatic proportional accounting.

Is QOTA free and open source?

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

Does QOTA work on Windows and Linux?

Yes! Native System Tray for Windows 10/11 with WS_EX_TOPMOST, plus 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