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)

Searching Database…

4.9K ·GitHub
这是什么?Quotio 是一款原生 macOS 菜单栏应用,用于管理 CLIProxyAPI——一个本地代理服务器,可统一多个 AI 提供商账号(Claude、OpenAI Codex、Qwen、Vertex AI、iFlow、Antigravity、Kiro、GitHub Copilot),并支持用量跟踪和自动故障转移。
它本身是编码助手,还是只管理我的 AI 账号?它是一个运行本地代理服务器的管理应用;你真正的编码代理(如 Claude Code 或 OpenCode)指向这个代理,而不是直接调用各个提供商。
怎么安装和设置?通过 Homebrew 安装,或从 Releases 页面下载已签名并公证的 .dmg(也可以在 Xcode 中从源码构建),然后启动代理,通过 OAuth 连接你的提供商账号,并自动配置你的 CLI 代理工具。
运行它需要什么?你需要 macOS 14.0(Sonoma)或更高版本以及网络连接,因为每个提供商账号都要通过 OAuth 认证。
可以通过 Quotio 把 Cursor 或 Trae 当作提供商使用吗?不可以,Cursor 和 Trae 只会被自动检测用于用量监控,不能作为代理提供商使用。
账号达到配额上限时自动故障转移是怎么工作的?Quotio 使用轮询(Round Robin)或填满优先(Fill First)路由策略在已连接的账号之间切换,并把用尽配额的账号冷却一段时间。
Quotio 能自动配置哪些 AI 编码 CLI?它可以一键把 Claude Code、Codex CLI、Amp CLI、OpenCode 和 Factory Droid 指向其本地代理。
不启动代理服务器也能查看配额吗?可以,独立配额模式(Standalone Quota Mode)让你无需运行代理即可查看配额和账号,方便快速查看。
这个应用支持哪些语言?Quotio 的界面支持英语、越南语和简体中文。
Size
93.5 MB
Stars
4.9K
Age
9mo
Commits · 90 Days