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