CLI tool
nguyenphutrong/quotio avatar
nguyenphutrong/quotio

Quotio: A macOS menu bar app that routes Claude Code and other CLI agents across multiple AI accounts

Project brief: Stop juggling AI accounts. Quotio is a beautiful native macOS menu bar app that unifies your Claude, Gemini, OpenAI, Qwen, and Antigravity subscriptions, with real-time quota tracking and smart auto-failover for AI coding tools like Claude Code, OpenCode, and Droid.

4,915 stars329 forksSwiftMIT

At a glance

What is it?
Quotio is a native macOS menu bar app that runs a local proxy, tracks quotas across Claude, OpenAI, Qwen, and other providers, and auto-fails over between accounts for CLI coding tools. This review covers its architecture, setup, limitations, and who should adopt it.
Who is it for?
Adopt Quotio if you are a macOS 14+ user who runs Claude Code, Codex CLI, or similar agents daily and juggle multiple paid AI accounts with separate quotas. Skip it if you rely on a single provider or need Windows support; Linux x64 users get only the CLI.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 4 days ago.
What is it written in?
Mainly Swift, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 14, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • nguyenphutrong/quotio4,915 ★ · +310
Star history
Repository2026-07-302026-11-14
nguyenphutrong/quotio4.6k4.9k

310 Stars in the last 107 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

The problem: quota juggling across AI coding subscriptions

Developers who use AI coding agents often hold several subscriptions: a Claude plan, an OpenAI Codex seat, a Qwen tier, maybe a GitHub Copilot subscription. Each provider enforces its own quota, and CLI tools like Claude Code or Codex CLI typically bind to one account at a time. When that account hits its limit, work stops until you manually switch credentials. Quotio attacks that friction directly. It is a native macOS menu bar application that runs a local proxy server, called CLIProxyAPI, and centralizes account management, quota tracking, and routing for those CLI agents. The target user is a macOS developer who runs multiple AI coding tools and wants one place to see remaining quota and to keep agents running when one account is exhausted.

How the proxy routing works

The core mechanism is a local proxy server that sits between your CLI agent and the AI providers. Quotio manages that proxy. You connect provider accounts through OAuth or API keys, and the app stores them. When an agent sends a request, the proxy forwards it to one of the connected accounts based on a routing strategy. The README says the app lets you start and monitor CLIProxyAPI and manage routing. Quotio tracks account limits and reset windows per account, and the macOS app includes notifications.

Getting it running: Homebrew, DMG, or Xcode

The README links an Install Quotio section, GitHub releases, and separate guides for the macOS app (`apps/macos/README.md`) and the CLI (`apps/cli/README.md`). The macOS app requires macOS 14 or later and includes automatic updates. The Rust CLI ships through npm and Homebrew as packages that contain native binaries, so neither install requires a Rust toolchain; it runs on macOS (Apple Silicon and Intel) and Linux x64.

Configuring agents and monitoring quota

Once the proxy is running, you connect provider accounts. The project description names Claude, Gemini, OpenAI, Qwen, and Antigravity, and the README says accounts can come from supported OAuth, API key, CLI, and native credential sources without copying secrets into project files. The README lists five coding agents Quotio can detect and configure: Claude Code, Codex CLI, Amp, OpenCode, and Factory Droid, preserving existing user settings. Quota and reset windows can be read from the menu bar, the desktop app, the terminal, JSON output, or a local REST API, and the Rust CLI gives text or JSON reports for quick checks.

Limitations: IDE monitoring only, macOS only, and a thin README

The macOS app requires macOS 14 or later. The Quotio CLI covers macOS (Apple Silicon and Intel) and Linux x64, so Linux users get terminal quota checks but not the desktop app; Windows is not listed for either product. Before relying on Quotio in your request path, check the macOS and CLI documentation for how the proxy handles crashes, expired OAuth tokens, and concurrent requests from multiple agents.

Alternatives: direct agent config, LiteLLM, or a hand-rolled proxy

The most direct alternative is to skip the proxy and configure each CLI agent with its own credentials. That works but gives you no central quota view and no automatic failover. A more comparable alternative is LiteLLM, an open source proxy that also routes requests across multiple providers and supports fallbacks. The difference in approach is that LiteLLM is a general-purpose Python server that you configure with YAML and run yourself, whereas Quotio is a native macOS app with a GUI, OAuth flows, and menu bar integration. LiteLLM is cross-platform and can be embedded in a backend, but it does not manage subscriptions or present a native quota dashboard. Quotio's value is the packaged experience: account connection, quota tracking, and agent configuration in one app, at the cost of the desktop app being tied to macOS and to the CLIProxyAPI binary.

Maintenance, licensing, and upgrade considerations

The project is under the MIT license, which permits commercial use, modification, and redistribution with attribution. That is permissive and should not block adoption for most teams. The repository is actively maintained: the latest release, v1.0.0-beta.11, was published on 2026-10-28, after v1.0.0-beta.10 and CLI v1.0.0-beta.7 on 2026-10-20. The macOS app includes automatic updates, which reduces the manual upgrade burden; before upgrading in a production workflow, check the release notes for breaking changes.

Who should adopt it and what to verify first

Quotio is a good fit for individual developers or small teams on macOS who run multiple AI coding agents and want to stop manually switching accounts when a quota runs out. It is less suited to organizations that need a Windows build or detailed failure logs and retry semantics. Before adopting, verify that your specific CLI agent is in the compatible list, confirm your provider's auth method is supported, and test how the proxy behaves when one account is exhausted mid-request. Also confirm that CLIProxyAPI works in your environment. If those checks pass, Quotio offers a concrete solution to a real daily annoyance: the menu bar shows quota at a glance, and the failover keeps your agents running when one subscription hits its cap.

Editorial conclusion

Adopt Quotio if you are a macOS 14+ user who runs Claude Code, Codex CLI, or similar agents daily and juggle multiple paid AI accounts with separate quotas. Skip it if you rely on a single provider or need Windows support; Linux x64 users get only the CLI. Before adopting, verify that your preferred providers are supported (the description names Claude, Gemini, OpenAI, Qwen, and Antigravity), confirm CLIProxyAPI works on your network, and test the failover behavior with your actual workload, including concurrent requests and proxy crashes.

Frequently asked questions

What does Quotio actually track on my machine?

Account limits and reset windows for providers including Claude, Gemini, OpenAI, Qwen and Antigravity. You can read them from the menu bar, the desktop app, the terminal, JSON output or a local REST API, and credentials are held through supported OAuth, API key, CLI and native sources rather than copied into project files.

How do I install the Quotio CLI without a Rust toolchain?

Use Homebrew or `npm install --global quotio`. Both distributed packages contain native binaries, so neither install requires a Rust toolchain. The CLI targets macOS on Apple Silicon and Intel plus Linux x64.

Does Quotio run on Windows today?

No build is listed for Windows: the macOS app needs macOS 14 or later and the CLI covers macOS plus Linux x64.

Which coding agents can Quotio send through a local proxy?

Claude Code, Codex CLI, Amp, OpenCode and Factory Droid. The macOS app detects and configures them to use the proxy it runs, while preserving existing user settings, and the CLI offers an optional loopback REST API for quota reports.

Official sources

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/nguyenphutrong-quotio.svg)](https://hysenlabs.com/projects/nguyenphutrong-quotio)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/nguyenphutrong-quotio.svg)](https://hysenlabs.com/projects/nguyenphutrong-quotio)

Was this useful?