quotio Documentation

Quotio

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 Copy Chapter

• 🔌 Multi-Provider Support: Connect accounts from 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, 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.
• 🌍 Multilingual: English, Vietnamese, and Simplified Chinese support.

🤖 Supported Ecosystem Copy Chapter

AI Providers Copy Section

IDE Quota Tracking (Monitor Only) Copy Section

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

Compatible CLI Agents Copy Section

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

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

🚀 Installation Copy Chapter

Requirements Copy Section

• macOS 14.0 (Sonoma) or later
• Internet connection for OAuth authentication

Homebrew (Recommended) Copy Section

brew tap nguyenphutrong/tap
brew install --cask quotio

Download Copy Section

Download the latest .dmg from the Releases page.

Official release artifacts are signed with Developer ID and notarized by Apple, so no Gatekeeper bypass is required.

Building from Source Copy Section

1. Clone the repository:

   bash Copy

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

2. Open in Xcode:

   bash Copy

   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 Copy Chapter

1. Start the Server Copy Section

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

2. Connect Accounts Copy Section

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

3. Configure Agents Copy Section

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

4. Monitor Usage Copy Section

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

⚙️ Settings Copy Chapter

• 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 Copy Chapter

Dashboard Copy Section

Providers Copy Section

Agent Setup Copy Section

Quota Monitoring Copy Section

API Keys Copy Section

Settings Copy Section

Menu Bar Copy Section

🤝 Contributing Copy Chapter

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

💬 Community Copy Chapter

Join our Discord community to get help, share feedback, and connect with other users:

⭐ Star History Copy Chapter

📊 Repo Activity Copy Chapter

💖 Contributors Copy Chapter

We couldn't have done this without you. Thank you! 🙏

📄 License Copy Chapter

MIT License. See LICENSE for details.