Quotio

The ultimate command center for your AI coding assistants on macOS.

Quotio is a native macOS application for managing CLIProxyAPI - a local proxy server that powers your AI coding agents. It helps you manage multiple AI accounts, track quotas, and configure CLI tools in one place.

✨ Features

• 🔌 Multi-Provider Support: Connect accounts from Gemini, Claude, OpenAI Codex, Qwen, Vertex AI, iFlow, Antigravity, Kiro, Trae, and GitHub Copilot via OAuth or API keys.
• 📊 Standalone Quota Mode: View quota and accounts without running the proxy server - perfect for quick checks.
• 🚀 One-Click Agent Configuration: Auto-detect and configure AI coding tools like Claude Code, OpenCode, Gemini CLI, and more.
• 📈 Real-time Dashboard: Monitor request traffic, token usage, and success rates live.
• 📉 Smart Quota Management: Visual quota tracking per account with automatic failover strategies (Round Robin / Fill First).
• 🔑 API Key Management: Generate and manage API keys for your local proxy.
• 🖥️ Menu Bar Integration: Quick access to server status, quota overview, and custom provider icons from your menu bar.
• 🔔 Notifications: Alerts for low quotas, account cooling periods, or service issues.
• 🔄 Auto-Update: Built-in Sparkle updater for seamless updates.
• 🌍 Bilingual: English and Vietnamese support.

🤖 Supported Ecosystem

AI Providers

IDE Quota Tracking (Monitor Only)

Note: These IDEs are only used for quota usage monitoring. They cannot be used as providers for the proxy.

Compatible CLI Agents

Quotio can automatically configure these tools to use your centralized proxy:

• Claude Code
• Codex CLI
• Gemini CLI
• Amp CLI
• OpenCode
• Factory Droid

🚀 Installation

Requirements

• macOS 15.0 (Sequoia) or later
• Internet connection for OAuth authentication

Download

Download the latest .dmg from the Releases page.

⚠️ Note: The app is not signed with an Apple Developer certificate yet. If macOS blocks the app, run:

xattr -cr /Applications/Quotio.app

Building from Source

1. Clone the repository:

   git clone https://github.com/nguyenphutrong/quotio.git
   cd Quotio
   

2. Open in Xcode:

   open Quotio.xcodeproj
   

3. Build and Run:

   • Select the "Quotio" scheme
   • Press Cmd + R to build and run

The app will automatically download the CLIProxyAPI binary on first launch.

📖 Usage

1. Start the Server

Launch Quotio and click Start on the dashboard to initialize the local proxy server.

2. Connect Accounts

Go to Providers tab → Click on a provider → Authenticate via OAuth or import credentials.

3. Configure Agents

Go to Agents tab → Select an installed agent → Click Configure → Choose Automatic or Manual mode.

4. Monitor Usage

• Dashboard: Overall health and traffic
• Quota: Per-account usage breakdown
• Logs: Raw request/response logs for debugging

⚙️ Settings

• Port: Change the proxy listening port
• Routing Strategy: Round Robin or Fill First
• Auto-start: Launch proxy automatically when Quotio opens
• Notifications: Toggle alerts for various events

📸 Screenshots

Dashboard

Providers

Agent Setup

Quota Monitoring

Menu Bar

🤝 Contributing

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/amazing-feature)
3. Commit your Changes (git commit -m 'Add amazing feature')
4. Push to the Branch (git push origin feature/amazing-feature)
5. Open a Pull Request

⭐ Star History

📄 License

MIT License. See LICENSE for details.