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 может значительно помочь в управлении лимитами и упрощении рабочего процесса, оборачивая полезную информацию в удобный интерфейс.

Открыть на GitHub: aqua5230/usage →

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