quotio README

The project's README from github.com/nguyenphutrong/quotio. As one markdown file: README.md.

Quotio

Quotio menu bar showing AI provider quota usage

Latest Quotio release for macOS Latest Quotio CLI release on npm Requires macOS 14 or later MIT license

Your command center for AI coding quotas, accounts, and local agents.

Quotio helps you see what quota remains, manage provider accounts, operate CLIProxyAPI, and connect your coding agents—from a native macOS app or the terminal.

Install Quotio · macOS app documentation · CLI documentation · GitHub releases

Stay ahead of your AI limits

Quotio puts provider usage and local tooling in one place, so you can spend less time checking dashboards and editing configuration files.

Choose your Quotio

Product Best for Platforms
Quotio for macOS Visual quota monitoring, account management, CLIProxyAPI lifecycle, agent setup, menu bar access, and automatic updates macOS 14 or later
Quotio CLI Fast text or JSON reports, scripting, saved accounts, and a loopback REST API macOS Apple Silicon/Intel and Linux x64

Both products live in this repository and share one goal: make AI coding usage visible and manageable without sending your credentials through a hosted Quotio service.

Sponsors

Standard Sponsors

Proxy-Seller logo Proxy-Seller gives you reliable proxy infrastructure for any workflow: private residential, mobile (4G/5G/LTE), ISP, and datacenter IPv4/IPv6 proxies, all with HTTP(S) and SOCKS5 support. Tap into 47M+ residential IPs across 220+ locations, target exactly the country, city, or ISP you need, and count on 99.7% uptime backed by 24/7 support. Quotio users get 15% off with promo code QUOTIO.
Explore Proxy-Seller →
x6.ai logo x6.ai: One API key for every major model. Official-key and proxy channels, up to 90% off, free credits on sign-up. Pay with Alipay, Google Pay, Apple Pay, Visa or Mastercard.
Explore x6.ai →

Interested in sponsoring Quotio? Contact [email protected].

Quotio for macOS

The native SwiftUI app is the full command center. It combines provider quota, account setup, local proxy controls, agent configuration, notifications, and updates in a desktop app that stays close in the menu bar.

Quotio for macOS dashboard with local proxy status and quota summaries

Read the complete macOS feature guide and screenshot gallery. The macOS guide is also available in Vietnamese, Simplified Chinese, and French.

Quotio CLI

The standalone Rust CLI brings quota checks to your terminal and automation. It supports a broad provider catalog, private saved-account storage, deterministic JSON reports, and an optional loopback REST API. Distributed packages contain native binaries, so npm and Homebrew installs do not require a Rust toolchain.

$ quotio providers
$ quotio usage
$ quotio usage --provider mock --format json

Read the CLI usage, provider, account, and API documentation.

Supported ecosystem

Quotio works with providers and services including Anthropic Claude, OpenAI Codex, Gemini and Vertex AI, GitHub Copilot, Qwen, Kiro, Antigravity, and many more. Provider availability and authentication methods vary between the macOS app and CLI; their product documentation contains the current support matrix.

The macOS app can configure these coding agents to use your local proxy:

Install Quotio

macOS app

brew install --cask nguyenphutrong/tap/quotio

You can also download the signed and notarized DMG from the latest macOS release.

CLI

Install the CLI with Homebrew:

brew install nguyenphutrong/tap/quotio

Or install the same native binaries through npm:

npm install --global quotio

See the CLI release-channel documentation for prerelease channels and supported release targets.

Repository layout

Development

Run local development commands from the repository root:

# Build and run
./scripts/dev cli -- usage
./scripts/dev macos --verify
./scripts/dev ios-sim [SIMULATOR_UDID]
./scripts/dev ios-device [DEVICE_ID]

# Test one product or the whole repository
./scripts/dev test cli
./scripts/dev test macos
./scripts/dev test ios [SIMULATOR_UDID]
./scripts/dev test all [SIMULATOR_UDID]

ios-sim and ios-device use the first compatible iPhone when you omit its ID. Before using ios-device, copy apps/ios/Config/Local.xcconfig.example to apps/ios/Config/Local.xcconfig and set your Apple development team. Run ./scripts/dev --help for the complete command list.

Use v* tags for macOS releases and cli-v* tags for CLI releases. See each product README for build, architecture, security, and release details.

Contributing

Bug reports, feature ideas, documentation improvements, and code contributions are welcome. Use the repository's GitHub issue templates to provide the context needed to investigate your request.

Read the contribution guide before opening a pull request: current development targets master; legacy macOS 0.x fixes, including CLI agent configuration, must start from and target v0.x.

License

Quotio is available under the MIT License.

iPhone companion

The native iOS companion and widgets live in apps/ios. It connects to Quotio hosts over HTTPS on a LAN or private VPN with a read-only device credential. Physical-device, Windows runtime and TestFlight acceptance are still pending; see the iOS README for setup and verification.

quotio (nguyenphutrong/quotio)

quota-monitor
Searching Database…

4.9K ·GitHub
What is this?Quotio is a native macOS menu bar app for managing CLIProxyAPI, a local proxy server that unifies multiple AI provider accounts (Claude, OpenAI Codex, Qwen, Vertex AI, iFlow, Antigravity, Kiro, GitHub Copilot) with quota tracking and automatic failover.
Is this a coding assistant itself, or does it just manage my AI accounts?It is a management app that runs a local proxy server; your actual coding agents like Claude Code or OpenCode point at this proxy instead of calling each provider directly.
How do I install and set it up?Install via Homebrew or download the signed, notarized .dmg from the Releases page (or build from source in Xcode), then start the proxy, connect your provider accounts via OAuth, and auto-configure your CLI agents.
What do I need to run it?You need macOS 14.0 (Sonoma) or later and an internet connection, since each provider account is authenticated via OAuth.
Can I use Cursor or Trae as providers through Quotio?No, Cursor and Trae are only auto-detected for quota monitoring and cannot be used as proxy providers.
How does the auto-failover work when an account hits its quota?Quotio switches between connected accounts using either a Round Robin or Fill First routing strategy, cooling down accounts that run out of quota.
Which AI coding CLIs can Quotio auto-configure?It can point Claude Code, Codex CLI, Amp CLI, OpenCode, and Factory Droid at its local proxy with one click.
Can I check my quotas without starting the proxy server?Yes, Standalone Quota Mode lets you view quota and accounts without running the proxy, for quick checks.
What languages does the app support?Quotio's interface is available in English, Vietnamese, and Simplified Chinese.
Size
94.3 MB
Stars
4.9K
Age
10mo
Commits · 90 Days