agy-hud — плагин
Плагин строки состояния для Antigravity CLI показывает модель, тариф, ветку Git, заполнение контекста и остаток квоты.
- 61 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Плагин запускает скрипт при каждом обновлении строки состояния и в фоне вызывает `agy -p /usage`.
Установка
Ручная установка
curl -fsSL -o agy-hud.tar.gz https://github.com/franksde/agy-hud/releases/latest/download/agy-hud.tar.gz && tar -xzf agy-hud.tar.gz && agy plugin install ./agy-hudТри команды из раздела Install From GitHub Release, объединенные в одну; затем в Antigravity CLI выполняют `/statusline` с путем к хуку.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Плагин запускает скрипт при каждом обновлении строки состояния и в фоне вызывает `agy -p /usage`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин на TypeScript для Node.js читает JSON строки состояния Antigravity CLI из стандартного ввода и рисует в терминале короткую панель. В ней модель и тариф, рабочий каталог, ветка Git, полоса заполнения контекста с числом токенов и остаток квоты с временем сброса. Панель включается встроенной командой `/statusline`. Если квоту нельзя получить напрямую, плагин в фоне запускает официальную `agy -p /usage` и кеширует ответ. Внешний вид задает файл `~/.config/agy-hud/config.json`: например, `show_icons: false` убирает значки и оставляет обычный текст.
Для кого. Пользователям Antigravity CLI, которым надо следить за расходом квоты и контекста прямо в терминале, не вызывая `/usage` вручную.
Подходит, если
- Длинная сессия съедает контекст, и нужна полоса заполнения перед глазами.
- Квота тарифа делится между задачами, и важно знать время сброса.
- Несколько веток Git открыты в разных терминалах, и нужно видеть, какая из них активна.
- Значки не отображаются в вашем шрифте, и нужен простой текстовый вариант панели.
Не подходит, если
- Используется другой агент: плагин читает строку состояния Antigravity CLI.
- CLI старше версии 1.1.0: команды `/statusline` в нем нет, нужна версия плагина 0.1.7.
- Нужен готовый пакет npm: плагин распространяется архивом с выпусков GitHub.
Пример запроса к агенту
Установи agy-hud для Antigravity CLI, сначала покажи, как будет выглядеть панель, и спроси, видны ли значки в моем терминале.Ограничения
Нужны Antigravity CLI 1.1.0 или новее и Node.js 18 или новее. Установка двухшаговая: `agy plugin install`, а затем команда `/statusline` с путем к `status-line.sh` или `status-line.cmd`. Значки берутся из шрифта Nerd Font: без него видны квадраты или `[?]`, тогда задают `show_icons: false`. Проверка квоты через loopback отключена с версии CLI 1.2.2, вместо нее работает `agy -p /usage`. На Windows нужна версия CLI, которая запускает строку состояния через `cmd.exe`, вероятно 1.1.2 или новее.
Как отключить. Очистите настройку `statusLine` командой `/statusline` и удалите плагин: каталог `~/.gemini/config/plugins/agy-hud`. Файл `~/.config/agy-hud/config.json` удаляют отдельно.
Частые вопросы
Как установить agy-hud?
Скачайте `agy-hud.tar.gz` с последнего выпуска GitHub, распакуйте и выполните `agy plugin install ./agy-hud`. Затем включите панель командой `/statusline ~/.gemini/config/plugins/agy-hud/hooks/status-line.sh`.
Почему вместо значков квадраты?
Терминалу не хватает шрифта Nerd Font. Задайте `{"show_icons": false}` в `~/.config/agy-hud/config.json` либо поставьте такой шрифт и укажите его в профиле терминала.
Чем проверить настройку?
Командой `doctor`: она печатает найденную конфигурацию, терминал, проверку шрифта и пробу значков.
Можно ли ставить через клон репозитория?
Нет. `agy plugin install` копирует каталог целиком, и в плагин попадут `.git/`, `src/` и тесты. Ставьте распакованный архив выпуска.
Нужен ли `npm install`?
Нет. Архив содержит собранный `dist/agy-hud.js`, достаточно Node.js 18 или новее.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин для Antigravity CLI выводит в нижней строке квоту API, расход токенов, ветку Git и нагрузку системы.
Строка состояния Claude Code в духе терминальных мониторов: загруженные плагины и скиллы, токены, расход, контекст и субагенты
Плагин для Claude Code: строка статуса с контекстом, лимитами за 5 часов и 7 дней, стоимостью и расходом Codex, Gemini и z.ai
Настраиваемая строка статуса для Claude Code: модель, ветка git, контекст, расход лимитов и другие виджеты
Строка состояния Claude Code с 15 пресетами: модель, уровень размышлений, контекст и лимиты подписки Pro, Max и Ultra
Монитор лимитов и расхода токенов для Claude Code, Codex, Antigravity и Grok CLI: меню macOS, трей Windows, отчеты в HTML
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| agy-hud (эта карточка) | нет | 61 | |
| Antigravity CLI Statusline | нет | 106 | другая строка состояния для Antigravity; здесь квота с временем сброса, полоса контекста и режим для установки агентом |
| Claude HUD | нет | 29 182 | панель для Claude Code; agy-hud рассчитан на Antigravity CLI |
Коротко о README
В README подробно разобраны версии CLI, на которых проверена работа, и частые проблемы со значками. Отдельный раздел написан для агента, который ставит плагин за пользователя.