herdr-agent-usage CLI
Плагин Herdr выводит в боковую панель модель, контекст и остаток квоты каждого агента, сгруппировав вкладки по Space.
- 156 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Читает сохраненные токены входа нескольких агентов, в том числе из macOS Keychain, и отправляет с ними запросы провайдерам.
- Установка создает хуки и интеграции в настройках агентов.
Установка
- Работает в
Ручная установка
git clone https://github.com/levi-qiao/herdr-agent-usage.git
cd herdr-agent-usage
./install.shСкрипт собирает бинарник, подключает плагин к Herdr и запускает настройку. Флаг `--agent claude,codex,omp` выбирает агентов.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Читает сохраненные токены входа нескольких агентов, в том числе из macOS Keychain, и отправляет с ними запросы провайдерам.
- Установка создает хуки и интеграции в настройках агентов.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
herdr-agent-usage дополняет панель Agent в терминальном мультиплексоре Herdr. У каждой вкладки с агентом видны провайдер, модель, заполнение контекста и счетчики подписки за 5 часов, 7 и 30 дней, а цвет значка показывает, работает агент, закончил или простаивает. Вкладки с общей подпиской схлопываются в одну строку. Квота читается из источника каждого агента: у Codex через app-server, у Claude Code через statusLine, у Cursor, Grok, Devin и OpenCode через их служебные адреса по текущему входу. Порог уведомлений о малом остатке по умолчанию выключен. Раскладка, поля и темп расхода настраиваются в панели `prefix+shift+q`.
Для кого. Пользователям Herdr, которые держат несколько агентов на разных подписках и устали заходить в каждый, чтобы узнать остаток лимита.
Подходит, если
- Три-четыре вкладки с Claude Code, Codex и Cursor работают параллельно, и нужно видеть, у кого кончается окно на 5 часов.
- Две вкладки тратят одну подписку, и важен общий остаток, а не два одинаковых счетчика.
- Заполнение контекста у сессии приближается к пределу, и его хочется видеть без команд.
- Темп расхода квоты нужно сверять с оставшимся временем окна.
Не подходит, если
- Herdr не используется: плагин работает только внутри его боковой панели.
- Нужна Windows: поддерживаются macOS и Linux.
- Не готов отдать плагину доступ к токенам входа агентов.
Пример запроса к агенту
Установи herdr-agent-usage только для найденных у меня агентов, проверь значки в этом терминале и покажи, какие подписки он увидел.Ограничения
Нужны Herdr 0.9.0 или новее, Rust-тулчейн из `rust-toolchain.toml`, macOS или Linux и поддерживаемый агентский CLI. Установка собирает бинарник и создает хуки в настройках агентов. Для Cursor и Muse на macOS при первом запуске требуется подтвердить доступ к Keychain. Значки отображаются после настройки шрифта в терминале. Для Kilo виден только месячный счетчик, а при общем кредитном балансе процент не показывается. Плагин читает сохраненные токены агентов и обращается с ними к служебным адресам провайдеров.
Как отключить. Отключите плагин в Herdr и удалите хуки и интеграции, которые создал `install.sh`. Сохраненные настройки и кеш лежат локально и удаляются вручную.
Частые вопросы
Какие агенты поддерживаются?
Claude Code, Codex, Cursor, Grok, Devin, OpenCode, Pi, omp, Kilo Code, Muse Code и Agy. Состав задает флаг `--agent`.
Как обновить плагин?
В каталоге репозитория выполнить `git pull --ff-only`, затем `./install.sh`. Настройки сохраняются.
Почему нужен доступ к Keychain?
У Cursor и Muse на macOS токен входа лежит в Keychain, а плагин читает его для запроса квоты. Разрешение нужно выдать один раз.
Показывает ли он остаток квоты Claude Code?
Да, через statusLine: окна на 5 часов и 7 дней. Ваш собственный statusLine сохраняется, плагин лишь добавляет темп расхода.
Есть ли уведомления о малом остатке?
По умолчанию они выключены. Порог задают в панели настроек `prefix+shift+q`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыКоманда /myoffice открывает в браузере «офис», где видно, чем занят каждый агент на машине: думает, ждет вас или закончил.
Agent Standup показывает сессии Claude Code, Codex и Mistral Vibe как живой созвон команды: кто работает, кто ждет.
Голосовое управление сессиями Claude Code и Codex на ваших машинах: агент на каждой машине связывает ее с облаком pitupitu.
Локальный просмотр, поиск и учет расходов по сессиям Claude Code, Codex и других агентов в одном веб-интерфейсе
HUD для агентов на экране Mac: квоты, токены и сессии Claude Code, Codex и других, плюс встроенный MCP для связи агентов.
CLI показывает агенту остатки квот Claude, Codex, Cursor, Copilot и еще 15 сервисов одним компактным отчетом.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| herdr-agent-usage (эта карточка) | нет | 156 | |
| herdr | нет | 48 519 | сам мультиплексор: держит сессии агентов живыми; плагин добавляет в его панель лимиты подписок |
| ccusage | нет | 19 349 | считает токены и стоимость по локальным логам; плагин показывает текущий остаток квоты в панели Herdr |
Коротко о README
Все агенты обслуживает один фоновый наблюдатель. Запросы объединяются с задержкой 60 секунд, итоговое обновление идет после завершения хода.