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
  • Скачать для macOS: Скачать архив с приложением с [GitHub Releases](https://github.com/aqua5230/usage/releases/latest), распаковать и переместить в папку «Программы».
  • Для других ОС: Можно запустить команду 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 — крепкий проект

ИмпульсТемпЗрелостьСообществоСвежестьСтартПродакшенДовериеДокументацияЭкосистема71
  • Импульс 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 →

Что нового на GitHub — короткие обзоры на русском Новые обзоры приходят в Telegram. Без спама, по делу.
Подписаться