Quotio — трекер квот AI-провайдеров для macOS и CLI

Quotio — нативное macOS-приложение и кроссплатформенная CLI-утилита для мониторинга квот AI-провайдеров, управления аккаунтами и автоматической настройки coding-агентов. Проект объединяет несколько подписок Claude, Gemini, OpenAI, Qwen и Antigravity в одном интерфейсе с отслеживание лимитов в реальном времени.

Зачем нужен Quotio

При работе с AI-инструментами разработчики сталкиваются с проблемой: каждый провайдер имеет свои лимиты, окна сброса квот и способы аутентификации. Один проект может использовать Claude для генерации кода, Gemini для ревью и OpenAI для документации — и у каждого из этих сервисов свои правила. Quotio решает эту задачу, предоставляя единый интерфейс для всех аккаунтов.

Основные возможности:

• Мониторинг квот в реальном времени — остаток лимитов и окна сброса отображаются в menu bar, десктопном приложении, терминале, через JSON или REST API. Вы всегда знаете, сколько запросов осталось до исчерпания лимита
• Единый интерфейс для аккаунтов — поддержка OAuth, API-ключей, CLI и нативных источников credentials без дублирования секретов в конфигах проектов. Все аккаунты хранятся локально в зашифрованном виде
• Управление локальным прокси — запуск и мониторинг CLIProxyAPI, маршрутизация запросов к нужным провайдерам. Прокси работает локально и не отправляет данные через сторонние сервисы
• Автоматическая настройка coding-агентов — Quotio определяет и настраивает Claude Code, Codex CLI, Amp, OpenCode и Factory Droid, сохраняя существующие пользовательские настройки
• Гибкость интерфейса — нативный macOS-опыт для повседневной работы или Rust CLI для скриптов, headless-систем и автоматизации

Ключевое преимущество — Quotio не является хостинговым сервисом. Все данные остаются на вашем устройстве, а credentials не покидают локальную среду. Это особенно важно для разработчиков, работающих с конфиденциальным кодом.

Два продукта в одном репозитории

Quotio предлагает два варианта использования с общей целью — сделать использование AI-инструментов прозрачным и управляемым без отправки credentials через сторонние сервисы.

Quotio для macOS

Нативное SwiftUI-приложение, работающее в menu bar. Полноценный центр управления: квоты провайдеров, настройка аккаунтов, управление локальным прокси, конфигурация агентов, уведомления и обновления.

Установка через Homebrew:

brew install --cask nguyenphutrong/tap/quotio

Или загрузка подписанного DMG из релизов на GitHub. Требуется macOS 14 или новее.

Quotio CLI

Кроссплатформенная CLI-утилита на Rust для терминала и автоматизации. Поддерживает широкий каталог провайдеров, приватное хранение аккаунтов, детерминированные JSON-отчёты и опциональный loopback REST API.

CLI-версия особенно полезна для:

• Скриптов и автоматизации — интеграция мониторинга квот в CI/CD пайплайны и bash-скрипты
• Headless-систем — серверы и контейнеры без графического интерфейса
• Быстрых проверок — мгновенный вывод остатка квоты прямо в терминале

Установка через Homebrew:

brew install nguyenphutrong/tap/quotio

Или через npm (нативные бинарники, Rust-тулчейн не нужен):

npm install --global quotio

Примеры использования:

# Показать список доступных провайдеров
$ quotio providers

# Проверить использование по всем аккаунтам
$ quotio usage

# Получить JSON-отчёт для конкретного провайдера
$ quotio usage --provider mock --format json

CLI поддерживает приватное хранение аккаунтов — credentials сохраняются локально и не требуют повторного ввода при каждом запуске. Опциональный loopback REST API позволяет другим локальным инструментам запрашивать данные о квотах программно.

Поддержка экосистемы

Quotio работает с провайдерами и сервисами: Anthropic Claude, OpenAI Codex, Gemini и Vertex AI, GitHub Copilot, Qwen, Kiro, Antigravity и многими другими. Доступность провайдеров и методы аутентификации различаются между macOS-приложением и CLI — полная матрица поддержки описана в документации каждого продукта.

macOS-приложение может автоматически настроить следующие coding-агенты для работы через локальный прокси:

• Claude Code — основной AI-ассистент для разработки от Anthropic
• Codex CLI — CLI-интерфейс для OpenAI моделей
• Amp — AI-инструмент для редактора кода
• OpenCode — open source AI coding assistant
• Factory Droid — агент для автоматизации разработки

Настройка агентов происходит автоматически — Quotio определяет установленные инструменты и конфигурирует их для работы через локальный прокси, сохраняя при этом существующие пользовательские настройки.

Архитектура репозитория

Структура проекта отражает разделение на два продукта с общей бизнес-логикой:

• apps/macos/ — Swift и SwiftUI приложение для macOS с нативным menu bar интерфейсом
• apps/cli/ — кроссплатформенный CLI-клиент на Rust с поддержкой macOS и Linux
• Packages/QuotioCore/ — общий Swift-пакет, содержащий бизнес-логику и модели данных для Apple-приложения
• .github/workflows/ — независимые пайплайны CI и релизов для каждого продукта

Такая архитектура позволяет развивать macOS и CLI версии независимо, при этом общая логика работы с провайдерами и аккаунтами переиспользуется через QuotioCore.

Разработка

Запуск проверок из корня репозитория:

# Ядро macOS и проверка архитектуры
swift test --package-path Packages/QuotioCore
./apps/macos/scripts/check_architecture.sh

# Приложение macOS
xcodebuild \
  -project apps/macos/Quotio.xcodeproj \
  -scheme Quotio \
  -configuration Debug \
  -destination 'platform=macOS' \
  test

# CLI
cargo test --manifest-path apps/cli/Cargo.toml --locked --all-features

Для релизов macOS используются теги v*, для CLI — cli-v*. Подробности сборки, архитектуры, безопасности и релизов описаны в README каждого продукта. Проект активно развивается — на момент написания статьи репозиторий насчитывает более 740 коммитов.

Лицензия

Проект распространяется под MIT License. Код открыт для community — баг-репорты, улучшения документации и code contributions приветствуются через шаблоны issues.

Quotio — это решение для разработчиков, которые работают с несколькими AI-провайдерами и хотят иметь полный контроль над своими квотами и аккаунтами без компромиссов в безопасности. Проект доступен на GitHub и готов к использованию прямо сейчас.