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.
- See quota at a glance. Track account limits and reset windows from the menu bar, desktop app, terminal, JSON output, or local REST API.
- Bring your accounts together. Use supported OAuth, API key, CLI, and native credential sources without copying secrets into project files.
- Run your local proxy with confidence. Start and monitor CLIProxyAPI, manage routing, and keep provider accounts close to the tools that use them.
- Connect coding agents faster. Detect and configure Claude Code, Codex CLI, Amp, OpenCode, and Factory Droid while preserving existing user settings.
- Choose the interface that fits. Use the native macOS experience for daily work or the Rust CLI for scripts, headless systems, and automation.
| 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.
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 jsonRead 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:
- Claude Code
- Codex CLI
- Amp
- OpenCode
- Factory Droid
brew install --cask nguyenphutrong/tap/quotioYou can also download the signed and notarized DMG from the latest macOS release.
Install the CLI with Homebrew:
brew install nguyenphutrong/tap/quotioOr install the same native binaries through npm:
npm install --global quotioSee the CLI release-channel documentation for prerelease channels and supported release targets.
apps/macos/— Swift and SwiftUI macOS application.apps/cli/— cross-platform Rust command-line client.Packages/QuotioCore/— shared Swift package for the Apple app..github/workflows/— independent CI and release pipelines for each product.
Run checks from the repository root:
# macOS core and architecture
swift test --package-path Packages/QuotioCore
./apps/macos/scripts/check_architecture.sh
# macOS app
xcodebuild \
-project apps/macos/Quotio.xcodeproj \
-scheme Quotio \
-configuration Debug \
-destination 'platform=macOS' \
test
# CLI
cargo test --manifest-path apps/cli/Cargo.toml --locked --all-featuresUse 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.
Quotio is available under the MIT License.
