The project's README from github.com/nguyenphutrong/quotio. As one markdown file: README.md.
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
Quotio puts provider usage and local tooling in one place, so you can spend less time checking dashboards and editing configuration files.
| 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.
|
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: 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].
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.
Read the complete macOS feature guide and screenshot gallery. The macOS guide is also available in Vietnamese, Simplified Chinese, and French.
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.
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:
brew install --cask nguyenphutrong/tap/quotio
You can also download the signed and notarized DMG from the latest macOS release.
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.
apps/macos/ — Swift and SwiftUI macOS application.apps/ios/ — native iPhone companion and WidgetKit extension.apps/cli/ — cross-platform Rust command-line client.Packages/QuotioCore/ — shared Swift package for the Apple app.scripts/dev — common local build, run, and test entrypoint..github/workflows/ — independent CI and release pipelines for each product.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.
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.
Quotio is available under the MIT License.
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.