usage: приложение для отслеживания квот на использование CLI инструментов
usage — это приложение для меню на macOS и панели задач Windows, которое показывает квоты и затраты на использование Claude Code, Codex, Antigravity и Grok CLI. Это полезно, чтобы не упустить момент, когда твои лимиты подходят к концу, особенно во время долгоиграющей работы.
Приложение работает локально и не требует вызовов API, что исключает задержки и возможные ошибки сетевого взаимодействия. У него есть 14 тем оформления и возможность генерации HTML-отчетов, что делает его кастомизацией более удобным и подходящим под любой стиль работы. В отличие от аналогичных приложений, оно просто и интуитивно понятно — ведь не нужно открывать дополнительные страницы или интерфейсы.
Работает на Python 3.13 и поддерживает платформы macOS и Windows. Помни, что использование требует наличия лог-файлов на твоем устройстве, поэтому без них приложение не сможет корректно показать квоты.
Проект usage представляет собой утилиту, которая помогает пользователям следить за своими лимитами в сервисах Claude Code, Codex, Antigravity и Grok CLI, отображая информацию об этом в строке меню macOS или в системном трее Windows. Основная цель проекта — предупредить пользователей о том, что они близки к исчерпанию своего лимита, чтобы избежать неожиданных неудобств во время работы.
Функциональность
Основные возможности usage включают:
- Мониторинг квот: Информация о лимитах отображается в виде цветовой шкалы от зеленого до красного, показывая, сколько осталось до предела.
- Поддержка Antigravity: Квота Antigravity отображается в отдельной карточке, обновляемой каждые несколько минут.
- Подсказки для работы: Утилита предлагает напоминания о необходимости очистки контекста, чтобы избежать неэкономного расхода токенов.
- Отчетность
- Темы оформления: Пользователь может выбрать одну из 16 визуальных тем для оформления интерфейса.
Установка и запуск
Установить usage можно несколькими способами:
- Через Homebrew (рекомендуется): Выполни команду:
brew install --cask aqua5230/usage/usage
uvx usage-cli в терминале, которая не требует установки.При первом запуске, особенно на macOS 15 и новее, возможно, потребуется подтвердить открытие приложения в системных настройках.
Ограничения
Утилита требует:
- macOS 12 или новее или Windows 10/11.
- Необходимо, чтобы пользователи хотя бы раз использовали сервисы Claude Code, Codex, Antigravity или Grok CLI, так как данные о использовании хранятся локально.
- Для версии с исходным кодом требуется Python 3.13.
- На данный момент модули с интерфейсом в строке меню доступны только для macOS и Windows, а на Linux доступна только терминальная версия.
Конфиденциальность
Данные о квотах получаются из локальных лог-файлов. В случае Antigravity информация загружается через публичный API. Утилита не отправляет личные данные на удаленные серверы и использует OAuth для доступа к необходимым квотам.
Таким образом, если ты работаешь с Claude Code, Codex, Antigravity или Grok CLI, usage может значительно помочь в управлении лимитами и упрощении рабочего процесса, оборачивая полезную информацию в удобный интерфейс.
Радар проекта: 71 из 100 — крепкий проект
- Импульс 6 ≈ 11 звёзд в месяц
- Темп разработки 100 767 коммитов за 12 недель
- Зрелость 77 проекту 6 месяцев, больше 100 релизов
- Сообщество 51 14 участников, 67 форков
- Свежесть 96 последний коммит — 6 дней назад
- Быстрый старт 65 есть: команда установки, сайт/демо
- Готовность к продакшену 85 релиз v0.34.21, автосборка, тесты
- Безопасность и доверие 80 лицензия AGPL-3.0, SECURITY.md
- Документация 100 README 20.9 тыс. знаков, 25 разделов, папка docs
- Экосистема 47 0 подписчиков на обновления, 20 тем
Как считаем
Только открытые данные GitHub на 14.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.
- Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
- Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
- Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
- Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
- Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
- Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
- Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
- Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
- Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
- Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.
Открыть на GitHub: aqua5230/usage →
RepoRadar