nguyenphutrong/quotio

Quotio – macOS command‑center for AI coding assistants

What it is – A native macOS app (written in Swift) that lets you run and control a local proxy server called CLIProxyAPI. The proxy routes requests from command‑line AI coding tools (e.g., Claude Code, Codex CLI, OpenCode) through a single point where you can manage multiple AI provider accounts, watch token quotas, and switch providers automatically.

Why it matters – When you use several AI‑powered code generators (OpenAI Codex, Anthropic Claude, etc.) you often have to keep separate API keys, watch usage limits, and configure each CLI tool manually. Quotio centralises all that:

• One place to add OAuth or API‑key credentials for many providers.
• Real‑time dashboard of traffic, token consumption and success rates.
• Automatic fail‑over (Round‑Robin or Fill‑First) when a provider’s quota runs low.
• Menu‑bar status, notifications, and Sparkle‑based auto‑updates.

Key features

• Multi‑provider support – Claude, OpenAI Codex, Qwen, Vertex AI, iFlow, Antigravity, Kiro, GitHub Copilot.
• Standalone quota view – See usage without launching the proxy.
• One‑click agent configuration – Detects installed CLI agents and writes the proxy settings for you.
• Live dashboard – Traffic, token usage, success‑rate graphs.
• Smart quota management – Visual per‑account tracking, automatic routing strategies.
• API‑key manager – Generate and store keys for the local proxy.
• Menu‑bar integration & notifications – Quick glance at server health and low‑quota alerts.
• Auto‑update – Built‑in Sparkle updater.
• Multilingual UI – English, Vietnamese, Simplified Chinese.

Supported ecosystem

• Providers – OAuth or service‑account JSON authentication as listed above.
• IDE quota monitoring – Cursor, Trae (read‑only monitoring).
• CLI agents – Claude Code, Codex CLI, Amp CLI, OpenCode, Factory Droid (auto‑configured to use the proxy).

Installation

1. Homebrew (recommended)

   brew tap nguyenphutrong/tap
   brew install --cask quotio
   

2. Direct download – Grab the latest .dmg from the GitHub Releases page.
3. Build from source – Clone the repo, open Quotio.xcodeproj in Xcode, and run the Quotio scheme.
   • The app will download the CLIProxyAPI binary on first launch.
   • macOS may block the unsigned app; run xattr -cr /Applications/Quotio.app to allow it.

Basic workflow

1. Start the server – Click Start on the dashboard.
2. Add accounts – In the Providers tab, authenticate via OAuth or paste API keys.
3. Configure agents – In the Agents tab, select an installed CLI tool and press Configure (auto or manual mode).
4. Monitor – Use the Dashboard, Quota, and Logs panels to watch traffic, token usage, and debug requests.
5. Adjust settings – Change listening port, routing strategy, auto‑start behaviour, and notification preferences in Settings.

Community & contribution

• Join the Discord server (link in README) for help and feedback.
• Fork, create a feature branch, commit, push, and open a PR to contribute.

License – MIT (see LICENSE).

---

Quotio is a practical tool for developers who rely on multiple AI code‑generation services and want a single, visual interface to manage credentials, quotas, and proxy routing on macOS.