# Quotio
Trung tâm điều khiển cho các trợ lý lập trình AI trên macOS.
Quotio là ứng dụng macOS để quản lý **CLIProxyAPI** - máy chủ proxy cục bộ cung cấp sức mạnh cho các agent lập trình AI. Quotio giúp bạn quản lý nhiều tài khoản AI, theo dõi hạn mức sử dụng và cấu hình các công cụ CLI tại một nơi. ## ✨ Tính năng - **🔌 Hỗ trợ Đa nhà cung cấp**: Kết nối tài khoản từ Claude, OpenAI Codex, Qwen, Vertex AI, iFlow, Antigravity, Kiro, Trae, và GitHub Copilot qua OAuth hoặc API key. - **📊 Chế độ Quota độc lập**: Xem quota và tài khoản mà không cần chạy proxy server - hoàn hảo để kiểm tra nhanh. - **🚀 Cấu hình Agent Một chạm**: Tự động phát hiện và cấu hình các công cụ như Claude Code, OpenCode. - **📈 Dashboard Thời gian thực**: Giám sát lưu lượng, token sử dụng và tỷ lệ thành công. - **📉 Quản lý Hạn mức**: Theo dõi quota từng tài khoản với chiến lược chuyển đổi tự động (Round Robin / Fill First). - **🔑 Quản lý API Key**: Tạo và quản lý các khóa API cho proxy. - **🖥️ Menu Bar**: Truy cập nhanh trạng thái, tổng quan quota và biểu tượng provider tùy chỉnh từ thanh menu. - **🔔 Thông báo**: Cảnh báo khi hạn mức thấp, tài khoản đang nghỉ, hoặc lỗi dịch vụ. - **🔄 Tự động Cập nhật**: Tích hợp Sparkle updater để cập nhật liền mạch. - **🌍 Đa ngôn ngữ**: Hỗ trợ tiếng Anh, tiếng Việt và tiếng Trung giản thể. ## 🤖 Hệ sinh thái hỗ trợ ### Nhà cung cấp AI | Provider | Phương thức xác thực | |----------|----------------------| | Anthropic Claude | OAuth | | OpenAI Codex | OAuth | | Qwen Code | OAuth | | Vertex AI | Service Account JSON | | iFlow | OAuth | | Antigravity | OAuth | | Kiro | OAuth | | GitHub Copilot | OAuth | ### Theo dõi Quota IDE (Chỉ giám sát) | IDE | Mô tả | |-----|-------| | Cursor | Tự động phát hiện khi cài đặt và đăng nhập | | Trae | Tự động phát hiện khi cài đặt và đăng nhập | > **Lưu ý**: Các IDE này chỉ dùng để theo dõi quota. Không thể sử dụng làm provider cho proxy. ### Agent tương thích Quotio có thể tự động cấu hình các công cụ sau: - Claude Code - Codex CLI - Amp CLI - OpenCode - Factory Droid ## 🚀 Cài đặt ### Yêu cầu - macOS 14.0 (Sonoma) trở lên - Kết nối internet để xác thực OAuth ### Homebrew (Khuyến nghị) ```bash brew tap nguyenphutrong/tap brew install --cask quotio ``` ### Tải xuống Tải file `.dmg` mới nhất từ trang [Releases](https://github.com/nguyenphutrong/quotio/releases). > ⚠️ **Lưu ý**: Ứng dụng chưa được ký bằng chứng chỉ Apple Developer. Nếu macOS chặn ứng dụng, chạy lệnh sau: > ```bash > xattr -cr /Applications/Quotio.app > ``` ### Build từ source 1. **Clone repo:** ```bash git clone https://github.com/nguyenphutrong/quotio.git cd Quotio ``` 2. **Mở trong Xcode:** ```bash open Quotio.xcodeproj ``` 3. **Build và chạy:** - Chọn scheme "Quotio" - Nhấn `Cmd + R` > Ứng dụng sẽ tự động tải binary `CLIProxyAPI` trong lần chạy đầu tiên. ## 📖 Hướng dẫn sử dụng ### 1. Khởi động Server Mở Quotio và nhấn **Start** trên dashboard để khởi động proxy server. ### 2. Kết nối Tài khoản Vào tab **Providers** → Chọn provider → Xác thực qua OAuth hoặc import credentials. ### 3. Cấu hình Agent Vào tab **Agents** → Chọn agent đã cài → Nhấn **Configure** → Chọn Automatic hoặc Manual. ### 4. Giám sát - **Dashboard**: Tình trạng chung và lưu lượng - **Quota**: Chi tiết sử dụng từng tài khoản - **Logs**: Nhật ký request/response để debug ## ⚙️ Cài đặt - **Port**: Đổi cổng proxy - **Chiến lược định tuyến**: Round Robin hoặc Fill First - **Auto-start**: Tự động khởi động proxy khi mở app - **Notifications**: Bật/tắt thông báo ## 📸 Hình ảnh ### Bảng điều khiển