Skip to content

About

QuotaOrbit

Resources

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

QuotaOrbit 🚀

Tauri v2 Rust React 18 TypeScript SQLite Tailwind CSS

The Local, Offline, Manual Quota & Account-Availability Tracker for Power Users of Antigravity AI Models.

Download • Features • Why Manual & Offline? • Keyboard Shortcuts • Architecture • Build from Source


Overview

When building complex software across long coding sessions, relying on a single AI account often leads to quota bottlenecks right in the middle of deep flow states. Juggling multiple Antigravity accounts solves the capacity limit, but introduces heavy cognitive overhead: Which account am I currently working on? Which model group did I exhaust? When exactly does the five-hour cooldown reset? Which account is fully rested and ready to switch to right now?

QuotaOrbit is an externalized memory and precision mission control desktop app built to solve this exact bookkeeping problem. It tells you the absolute truth about your account quotas at a glance, right from your system tray or keyboard shortcut, without ever getting in your way.


Interface Preview

📸 Click here to view the full Interface Preview and Screenshots


Download & Install

You don't need to build from source to use QuotaOrbit! Pre-compiled installers are automatically built and published.

  1. Go to the Releases page of this repository.
  2. Download the .msi (Windows Installer) or .exe (NSIS Installer) file from the latest release assets.
  3. Run the installer and you're good to go!

Note

Windows SmartScreen Alert: Because QuotaOrbit is a free, open-source indie app, it is not signed with an expensive corporate Code Signing Certificate. When you first run the installer, Windows may show a blue "Windows protected your PC" popup. Simply click "More info" and then "Run anyway".


Why Manual & Offline?

Unlike brittle browser extensions or risky third-party wrappers, QuotaOrbit is deliberately 100% manual and local:

  • 🔒 Zero Credentials or Cookies Required: QuotaOrbit never asks for passwords, OAuth tokens, API keys, or browser sessions.
  • 🛡️ Air-Gapped Privacy: It never connects to external servers, never scrapes web pages, and never injects scripts into your browser.
  • ⚡ Deterministic Single Source of Truth: All state is stored locally on your machine (%APPDATA%\com.ayush.quotaorbit\quotaorbit.sqlite3). QuotaOrbit derives cooldown statuses mathematically from precise timestamps, ensuring countdown accuracy survives laptop sleep cycles, reboots, and clock adjustments.

Key Features

🌌 Dual Model Group & Plan-Aware Tracking

  • Two Independent Model Groups per Account: Track Gemini Models (Pro / Flash) and Claude & GPT Models (Sonnet / Opus / GPT-4o) separately for every account.
  • Plan-Specific Quota Rules:
    • AI Pro Accounts: Accurately tracks both Five-Hour (5h) and Weekly (7d) limits. Enforces the strict domain dependency rule: if an account hits a Weekly limit, its Five-Hour quota is automatically BLOCKED BY WEEKLY (Locked) even if the five-hour timer itself expires.
    • Free Tier Accounts: Tracks only Weekly (7d) quotas, keeping UI cards clean and uncluttered.

🎯 Next Move Intelligence (Switch to Candidate)

  • Automatically evaluates all your tracked accounts and recommends the single best candidate to switch to next.
  • Uses multi-tier ranking: prioritizes high-priority accounts (High Priority ⭐), checks overall model readiness across both model groups, and breaks ties using least-recently-used (LRU) timestamps.
  • One-click Switch & Mark Active button instantly updates your active coding session.

⏱️ Interactive Cooldown & Timer Management

  • Mark Limit Reached: Instantly trigger a cooldown when an AI model notifies you that your quota is exhausted.
  • Restart Limit Timer: Reset a running cooldown to its standard default duration (5 hours for Five-Hour limits, 7 days for Weekly limits).
  • Edit Reset Time: Adjust remaining countdown time with live duration inputs (Days, Hours, Minutes). Enforces strict domain validation (clamping inputs so you can never accidentally enter >5 hours on a 5-hour limit or >7 days on a weekly limit).
  • Mark Available Now (Clear): Instantly clear any cooldown and mark the quota ready immediately.
  • Estimated Time Until Next Ready Account: When all accounts are cooling down, the dashboard analyzes your exact timeline and displays a clear countdown (e.g., Next account ready in: 2h 14m).

📊 Analytics & Efficiency Scoring

  • Historical Usage Analytics: Hit Ctrl + E to open the Analytics Drawer. View total events recorded, most active days, and model-group breakdowns.
  • Interactive Usage Heatmaps: Explore your quota exhaustion patterns visually across Weekly, Monthly, and Yearly GitHub-style heatmaps.
  • Account Efficiency Scores: QuotaOrbit analyzes your active coding session durations against your quota limit hits, scoring every account (0-100) so you know exactly which ones are doing the heavy lifting.

🖥️ System Tray & Native Desktop Integration

  • Starts Maximized & Full Screen: Opens cleanly in a spacious, full-window mission control layout (1440x900 resizable fallback).
  • Drag-and-Drop Reordering: Rearrange your accounts on the dashboard freely. The order persists in your local SQLite database automatically.
  • Background Tray Monitoring: Runs silently in the background (>10MB RAM) with a system tray icon (Left-click to toggle dashboard, Middle-click to switch to next ready account, Right-click for quick actions).
  • Native OS & Toast Notifications: Alerts you via Windows desktop notifications the exact moment a cooling quota finishes renewing. In-app Toast notifications provide instant visual feedback for manual actions.
  • Deterministic Avatars: Instantly recognize your accounts in lists with brightly colored, auto-generated initials avatars.

⌨️ Global & In-App Keyboard Shortcuts

  • Control QuotaOrbit from any application using robust system-wide hotkeys:
    • Alt + Shift + Q: Toggle QuotaOrbit Dashboard Window (Open/Hide).
    • Alt + Shift + L: Focus Active Account (Navigate to active session card).
    • Alt + Shift + R: Focus Next Recommended Candidate (Navigate to recommendation panel).
    • Alt + Shift + M: Quick Mark Limit Reached (Open limit reached modal directly).
    • Alt + Shift + N: Add New Account (Open create account modal directly).
    • Alt + Shift + E: Open Historical Analytics Modal.

📦 Data & Backup Suite

  • Auto-Backup on Exit: QuotaOrbit guarantees data safety by automatically creating a background JSON backup of your database every single time you close the application.
  • Export JSON Backup: Download a complete snapshot of all accounts and quota histories to your Downloads folder with instant visual confirmation banners.
  • Import JSON with Dry-Run Diff Preview: Before importing a backup file, preview exact changes in an interactive modal (showing Accounts to Add, Update, Archive, and Quotas to Reset).

Keyboard Shortcuts Reference

Shortcut Scope Action
Alt + Shift + Q Global (System-Wide) Toggle Dashboard Window (Show/Hide to Tray)
Alt + Shift + L Global (System-Wide) Focus Active Account Card
Alt + Shift + R Global (System-Wide) Focus Next Recommended Candidate Panel
Alt + Shift + M Global (System-Wide) Quick Mark Limit Reached Modal
Alt + Shift + N Global (System-Wide) Open Add New Account Modal
Alt + Shift + E Global (System-Wide) Open Historical Analytics Modal
Ctrl + K / Cmd + K In-App Focus Search Bar (Filter accounts by name or email)
Ctrl + N / Cmd + N In-App Open Add New Account Modal
Ctrl + M / Cmd + M In-App Open Mark Limit Reached Modal
Ctrl + S / Cmd + S In-App Open Settings Drawer
Ctrl + E / Cmd + E In-App Open Historical Analytics Modal

Architecture Overview

QuotaOrbit is engineered with strict separation of concerns, ensuring that UI formatting never corrupts core domain calculations:

┌─────────────────────────────────────────────────────────────┐
│  frontend/  (React 18 + TypeScript + Vite + Tailwind CSS)   │
│  Renders computed DTOs. Zero domain state logic.            │
└───────────────────────────▲─────────────────────────────────┘
                            │ tauri::invoke (Typed IPC bridge)
┌───────────────────────────┴─────────────────────────────────┐
│  src-tauri/  (Tauri 2 Shell + Rust Async Runtime)           │
│  commands/*   -- IPC command handlers returning clean DTOs  │
│  dashboard.rs -- Single O(1) aggregate state snapshot       │
│  tray/ & notifications/ -- System tray & background scanner │
└───────────────────────────▲─────────────────────────────────┘
                            │ Direct Rust function calls
┌───────────────────────────┴─────────────────────────────────┐
│  crates/persistence/  (SQLite via rusqlite + Migrations)    │
│  repository.rs -- All SQL queries and transactional logic   │
└───────────────────────────▲─────────────────────────────────┘
                            │ Pure domain types
┌───────────────────────────┴─────────────────────────────────┐
│  crates/domain/  (Pure Rust + Zero I/O + 100% Tested)       │
│  state_machine.rs -- QuotaStatus & AI Pro weekly dependency │
│  recommendation.rs -- Least-recently-used candidate ranking │
└─────────────────────────────────────────────────────────────┘

For a deeper dive into the architectural layering and data flow, read docs/ARCHITECTURE.md. For historical product requirements and domain scope decisions, read docs/PLANNING.md.


Building from Source

Prerequisites (Windows)

  1. Rust Toolchain: Install via rustup.rs (ensure you are using the latest stable cargo / rustc).

  2. Node.js 20+: Required for bundling the React frontend.

  3. Tauri CLI v2: Install globally via cargo:

    cargo install tauri-cli --version "^2.0"
  4. Microsoft C++ Build Tools: Required for native Windows compilation (Windows 10/11 SDK + C++ build tools).

  5. WebView2 Runtime: Included by default on updated Windows 10/11 machines.

Running Locally (Development Mode)

Run the application with hot-reloading for both the React UI and Rust shell:

# 1. Install frontend dependencies
cd frontend
npm install
cd ..

# 2. Launch Tauri 2 in development mode
cargo tauri dev

Running the Test Suites

Verify all core domain rules, recommendation ranking algorithms, and SQLite transactional workflows:

# Run all unit and integration tests across all workspace crates
cargo test --workspace

Building Production Installers

To generate self-contained Windows installers (.msi and .nsis executables) or the standalone application binary:

cargo tauri build

Once compilation finishes, because QuotaOrbit is structured as a Cargo workspace, all build artifacts are output to the root target/release/ directory:

  • NSIS Setup Installer (Recommended for installation): target/release/bundle/nsis/QuotaOrbit_0.1.0_x64-setup.exe
  • MSI Windows Installer: target/release/bundle/msi/QuotaOrbit_0.1.0_x64_en-US.msi
  • Standalone Portable Binary: target/release/quotaorbit-app.exe

License & Author

QuotaOrbit is developed and maintained by Ayush Kumar (@Ayushkumar418).

Released under the MIT License. All user data, account labels, and quota logs remain strictly on your local machine. Nothing is ever uploaded or shared.

About

QuotaOrbit

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages