agy-hud plugin
A status-line plugin for the Antigravity CLI that shows the model, plan, Git branch, context fill and remaining quota.
- 61 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The plugin runs a script on every status-line refresh and calls `agy -p /usage` in the background.
Install
Manual install
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-hudThe three commands from Install From GitHub Release joined into one; then run `/statusline` with the hook path in the Antigravity CLI.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The plugin runs a script on every status-line refresh and calls `agy -p /usage` in the background.
This is third-party code. Review the repository files before installing.
What it does
The TypeScript plugin for Node.js reads the Antigravity CLI status-line JSON from standard input and draws a short panel in the terminal. It shows the model and plan, the working directory, the Git branch, a context fill bar with a token count and the remaining quota with its reset time. The panel is enabled with the built-in `/statusline` command. When quota cannot be read directly, the plugin runs the official `agy -p /usage` in the background and caches the answer. Appearance comes from `~/.config/agy-hud/config.json`: for example, `show_icons: false` drops icons and leaves plain text.
Who it is for. Antigravity CLI users who want to watch quota and context use right in the terminal without calling `/usage` by hand.
Good fit when
- A long session eats context and you need a fill bar in view.
- A plan quota is shared across tasks and the reset time matters.
- Several Git branches are open in different terminals and you need to see which is active.
- Icons do not render in your font and you need a plain-text panel.
Not a fit when
- A different agent is in use: the plugin reads the Antigravity CLI status line.
- The CLI is older than 1.1.0: it lacks `/statusline` and plugin version 0.1.7 is needed.
- An npm package is needed: the plugin ships as an archive from GitHub releases.
Example request
Install agy-hud for the Antigravity CLI, first show what the panel will look like and ask whether icons render in my terminal.Limitations
Antigravity CLI 1.1.0 or newer and Node.js 18 or newer are required. Installation is two steps: `agy plugin install`, then the `/statusline` command with the path to `status-line.sh` or `status-line.cmd`. Icons come from a Nerd Font: without one you see boxes or `[?]`, and then `show_icons: false` is set. The loopback quota probe has been off since CLI 1.2.2 and `agy -p /usage` runs instead. On Windows the CLI must run the status line through `cmd.exe`, likely 1.1.2 or newer.
How to disable. Clear the `statusLine` setting with `/statusline` and delete the plugin: the `~/.gemini/config/plugins/agy-hud` directory. Remove `~/.config/agy-hud/config.json` separately.
FAQ
How do I install agy-hud?
Download `agy-hud.tar.gz` from the latest GitHub release, extract it and run `agy plugin install ./agy-hud`. Then enable the panel with `/statusline ~/.gemini/config/plugins/agy-hud/hooks/status-line.sh`.
Why do I see boxes instead of icons?
The terminal lacks a Nerd Font. Set `{"show_icons": false}` in `~/.config/agy-hud/config.json` or install such a font and select it in the terminal profile.
How do I check the setup?
Run `doctor`: it prints the resolved config, the detected terminal, a font scan and an icon probe.
Can I install from a repository clone?
No. `agy plugin install` copies the whole directory, so `.git/`, `src/` and tests would end up in the plugin. Install the extracted release archive.
Is `npm install` needed?
No. The archive holds the built `dist/agy-hud.js`, and Node.js 18 or newer is enough.
Discussion
No questions or reviews yet.
Related
PluginsPlugin that fills the Antigravity CLI footer with API quota, token usage, Git branch and system load readouts.
A Claude Code status line in the spirit of terminal monitors: loaded plugins and skills, tokens, cost, context and subagents
A Claude Code plugin: a status line with context, 5-hour and 7-day limits, cost and usage of Codex, Gemini and z.ai
A customizable status line for Claude Code: model, git branch, context, usage limits and other widgets
A Claude Code statusline with 15 presets: model, reasoning effort, context and Pro, Max and Ultra usage limits at a glance
A limits and token spend monitor for Claude Code, Codex, Antigravity and Grok CLI: macOS menu bar, Windows tray, HTML reports
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| agy-hud (this card) | no | 61 | |
| Antigravity CLI Statusline | no | 106 | another Antigravity status line; this one adds quota with reset time, a context bar and an agent-led install mode |
| Claude HUD | no | 29,182 | a panel for Claude Code; agy-hud targets the Antigravity CLI |
README in short
The README details the CLI versions it was verified on and common icon problems. A separate section is written for an agent installing the plugin on a user behalf.