quotio README

The project's README from github.com/nguyenphutrong/quotio. As one markdown file: README.md.

Quotio

Quotio Banner

Platform macOS Language Swift License MIT Vietnamese Chinese French

nguyenphutrong%2Fquotio | Trendshift nguyenphutrong%2Fquotio | Trendshift nguyenphutrong%2Fquotio | Trendshift nguyenphutrong%2Fquotio | Trendshift nguyenphutrong%2Fquotio | Trendshift nguyenphutrong%2Fquotio | Trendshift

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

🤖 Supported Ecosystem

AI Providers

Provider Auth Method
Anthropic Claude OAuth
OpenAI Codex OAuth
Qwen Code OAuth
Vertex AI Service Account JSON
iFlow OAuth
Antigravity OAuth
Kiro OAuth
GitHub Copilot OAuth

IDE Quota Tracking (Monitor Only)

IDE Description
Cursor Auto-detected when installed and logged in
Trae Auto-detected when installed and logged in

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:

🚀 Installation

Requirements

brew tap nguyenphutrong/tap
brew install --cask quotio

Download

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

  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

⚙️ Settings

📸 Screenshots

Dashboard

Dashboard

Providers

Providers

Agent Setup

Agent Setup

Quota Monitoring

Quota Monitoring

API Keys

API Keys

Settings

Settings

Menu Bar

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

💖 Contributors

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

📄 License

MIT License. See LICENSE for details.

quotio (nguyenphutrong/quotio)

auto-update
Searching Database…

4.9K ·GitHub
What is this?Quotio is a native macOS menu bar app for managing CLIProxyAPI, a local proxy server that unifies multiple AI provider accounts (Claude, OpenAI Codex, Qwen, Vertex AI, iFlow, Antigravity, Kiro, GitHub Copilot) with quota tracking and automatic failover.
Is this a coding assistant itself, or does it just manage my AI accounts?It is a management app that runs a local proxy server; your actual coding agents like Claude Code or OpenCode point at this proxy instead of calling each provider directly.
How do I install and set it up?Install via Homebrew or download the signed, notarized .dmg from the Releases page (or build from source in Xcode), then start the proxy, connect your provider accounts via OAuth, and auto-configure your CLI agents.
What do I need to run it?You need macOS 14.0 (Sonoma) or later and an internet connection, since each provider account is authenticated via OAuth.
Can I use Cursor or Trae as providers through Quotio?No, Cursor and Trae are only auto-detected for quota monitoring and cannot be used as proxy providers.
How does the auto-failover work when an account hits its quota?Quotio switches between connected accounts using either a Round Robin or Fill First routing strategy, cooling down accounts that run out of quota.
Which AI coding CLIs can Quotio auto-configure?It can point Claude Code, Codex CLI, Amp CLI, OpenCode, and Factory Droid at its local proxy with one click.
Can I check my quotas without starting the proxy server?Yes, Standalone Quota Mode lets you view quota and accounts without running the proxy, for quick checks.
What languages does the app support?Quotio's interface is available in English, Vietnamese, and Simplified Chinese.
Size
93.5 MB
Stars
4.9K
Age
9mo
Commits · 90 Days