herdr-agent-usage (senna-lang) — плагин
herdr-agent-usage
Плагин Herdr с панелью лимитов: заполнение контекста, кеш промптов и остаток подписки по каждому агенту.
- 66 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Плагин читает локальные файлы агентов, включая метаданные учетных данных, и для окон OpenCode Go может использовать cookie браузера через связку ключей.
- Запрашивает остаток у серверов провайдеров с вашими токенами, когда включены Grok и OpenCode Go.
Установка
- Работает в
Ручная установка
herdr plugin install senna-lang/herdr-agent-usageНужен Herdr 0.7.5 или новее. В неинтерактивных оболочках добавьте `--yes`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Плагин читает локальные файлы агентов, включая метаданные учетных данных, и для окон OpenCode Go может использовать cookie браузера через связку ключей.
- Запрашивает остаток у серверов провайдеров с вашими токенами, когда включены Grok и OpenCode Go.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин Agent Usage для терминального мультиплексора Herdr показывает расход ресурсов агентов, которые работают в его панелях. В боковой подписи каждой панели видно, сколько контекстного окна занято сессией, какой процент попаданий в кеш промптов и сколько осталось в самом тесном окне лимита, например за 5 часов. Отдельная панель собирает окна на 5 часов, 7 и 30 дней для Claude, Codex, OpenCode Go и Grok, со счетчиком до сброса и указанием, какая из открытых панелей тратит лимит. Для API-ключей вместо подписки считаются токены и стоимость по провайдеру за сутки, неделю и месяц. При падении остатка ниже порогов 50, 20, 10 и 5 процентов приходит всплывающее уведомление.
Для кого. Пользователям Herdr, которые держат в панелях сразу несколько агентов на подписках и хотят видеть расход лимита до того, как работа остановится.
Подходит, если
- В нескольких панелях работают Claude Code и Codex, а лимит за 5 часов заканчивается неожиданно.
- Сессия разрослась, и нужно решить, пора ли начинать новую до переполнения контекста.
- Агент ходит к прямому API-ключу, и надо видеть, сколько токенов и долларов ушло за сутки.
- Подписка у вас на несколько аккаунтов, и остаток каждого окна нужен в одном месте.
- Низкий процент попаданий в кеш подсказывает, что сессию стоит перезапустить.
Не подходит, если
- Вы не работаете в Herdr: плагин встраивается только в его боковую панель и команды.
- Нужны точные счета как в личном кабинете: значения строятся по локальным файлам и могут расходиться с серверными окнами.
- Используется Windows: поддерживаются macOS и Linux.
Пример запроса к агенту
Покажи панель лимитов Agent Usage и скажи, у какой из открытых панелей меньше всего остатка за 5 часов.Ограничения
Нужен Herdr 0.7.5 или новее, macOS или Linux. Установка собирает бинарный файл `usagebar` локальным Go 1.25 или скачивает готовый из релизов. Установка не меняет `~/.config/herdr/config.toml`, поэтому подписи и уведомления включают отдельным действием `usagebar.setup`. Данные берутся из локальных файлов агентов и могут расходиться с официальными окнами. Для окон OpenCode Go нужен cookie сайта opencode.ai, иначе остается оценка по локальной базе. У Cursor виден только контекст, лимитов нет.
Как отключить. Удалите плагин средствами Herdr и уберите добавленные строки подписей из `~/.config/herdr/config.toml`. Статусные снимки лежат в папках `herdr-usagebar` каждого агента.
Частые вопросы
Как установить Agent Usage в Herdr?
Выполните `herdr plugin install senna-lang/herdr-agent-usage`, в неинтерактивной оболочке добавьте `--yes`. Затем запустите `herdr plugin action invoke usagebar.setup` и перезагрузите конфигурацию командой `herdr server reload-config`.
С какими агентами работает плагин?
Claude Code, Codex, OpenCode, Grok и другие вроде Hermes Agent, Pi и Devin. Полные окна лимитов видны не у всех: у Cursor, например, есть только заполнение контекста.
Откуда берутся цифры?
Из файлов, которые агенты уже хранят локально: сессии, откаты Codex, `~/.claude.json`. Сетевые запросы идут только для окон OpenCode Go и кредитов Grok и пропускаются без нужных учетных данных.
Чем плагин отличается от другого herdr-agent-usage?
Этот проект на Go добавляет строки кеша и лимитов в боковую подпись, предупреждения о низком остатке и панель окон на 5 часов, 7 и 30 дней. Версия levi-qiao группирует вкладки по пространствам.
Заменяет ли панель счета провайдера?
Нет. Значения строятся по локальным файлам и могут отличаться от серверных окон, если вы работали на другой машине. Для точных сумм откройте кабинет провайдера.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин Herdr называет вкладки и панели по каталогу, ветке Git и текущей работе агента, чтобы сессии Claude Code различались.
Локальный шлюз для кодинг-агентов: единая настройка поставщиков моделей, трассировка вызовов и стоимость каждого запроса.
Локальная панель для параллельных сессий Claude Code и Codex: кто работает, кто ждет ответа, плюс 3D-аквариум и Stream Deck
hermesd в одном терминале показывает шлюз, сессии, токены, cron и логи Hermes Agent без записи в его данные.
Плагин учит Claude Code и Codex управлять терминалом agterm для macOS через agtermctl: сессии, панели, оверлеи и статусы агентов
Tokscale
tokscale
CLI с интерактивным TUI для учета расхода токенов и стоимости работы AI-кодинг-агентов: Claude Code, Codex, Copilot, Cursor и других
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| herdr-agent-usage (senna-lang) (эта карточка) | нет | 66 | |
| herdr-agent-usage | нет | 160 | группирует вкладки по пространствам Herdr; плагин senna-lang добавляет кеш, предупреждения и панель окон на 5 часов, 7 и 30 дней |
| ccusage | нет | 19 415 | считает расход по журналам из командной строки; плагин показывает его прямо в панелях Herdr |
Коротко о README
Описание проекта начинается с мониторинга контекста и лимитов агентов внутри Herdr. Подробно разобраны источники данных по каждому агенту, настройка нескольких аккаунтов Claude, Codex и Grok и проверка изменений апстрима.