A fast, configurable statusline for Google Antigravity
See the code
A fast, configurable statusline for Google Antigravity's CLI (agy).
See your model, Gemini 5h/7d quotas, context window, git branch and more at a glance. Pick widgets, themes and layout from an interactive editor. One command to install, no dependencies.
You need Node.js 20+ and the Antigravity CLI. Works on Windows, macOS, Linux and WSL (WSL notes).
npx agy-powerline init # install the statusline into agy
npx agy-powerline configure # optional: pick widgets, theme and layout
agy # start Antigravity
init asks before replacing anything and backs up Antigravity's settings.json first. Restart agy once after init. Details: what init does.
For a Nerd Font–free terminal, turn on ASCII mode (i in configure).
npx agy-powerline configure opens an editor with a live preview of your bar. Use ← → to switch between Widgets, Presets, Themes, Layout and Powerline, ↑ ↓ to move, Enter to pick, q to save and quit. The keys for each screen are shown at the bottom; the full list is in Configuration.
Changes apply to a running agy on its next refresh.
Start from a preset, then adjust:
| Preset | Shows |
|---|---|
default | Model, context, git; 5h and 7d quotas with resets on a second row |
compact | One line: short model, tightest quota, context %, git |
workspace | Project, git, agent state, model; context and tightest quota |
limits | Every quota (5h, 7d, third-party), one per row |
full | Everything: session, project and git; context, tokens and cache; both quotas |
| Terminal background | Themes |
|---|---|
| Dark | dark-aurora (default), dark-ocean, dark-ember, dark-forest, dark-neon, dark-mono, dark-nocturne, dark-onyx, dark-metro |
| Light | light-paper, light-sky, light-sunset, light-cream |
| Color-blind safe | colorblind-dark, colorblind-light |
| Your own colors | custom (how) |
Preview them all with npx agy-powerline theme --gallery.
Pills (default): powerline-style capsules. Choose round, angled, slanted or flat shapes, and optionally a blank line between rows.
Lines: the same information as plain colored text.
| Widget | Shows |
|---|---|
model | The model in use |
fiveHourBar, weeklyBar | 5h / 7d quota left as a meter, with a pace marker |
fiveHourPct, weeklyPct | 5h / 7d quota left as a percentage |
fiveHourReset, weeklyReset | Time until the quota resets, or the reset time |
quota | The quota closest to running out, with its reset |
thirdPartyFiveHour, thirdPartyWeekly | Third-party model quotas |
context, contextPct, contextTokens | Context window used: meter, percentage or token counts |
git | Branch, uncommitted changes and ahead/behind |
project, cwd | Project folder, current folder |
agentState, plan, sandbox, artifacts, version | What the agent is doing, your plan, sandbox, artifacts, CLI version |
totalTokens, cacheHit, cacheRead, cacheCreate | Session tokens and prompt cache usage |
ram | Memory used on your machine |
customText, exec | Your own text, or the output of a shell command |
A widget with nothing to show hides itself. Widgets can be recolored, made label-free or given their own alert thresholds: see Configuration.
| Command | What it does |
|---|---|
npx agy-powerline init [--yes] | Install or update the statusline |
npx agy-powerline configure | Open the editor (alias config) |
npx agy-powerline preset <name> | Apply a preset (--list to see them) |
npx agy-powerline theme <name> | Switch theme (--list, --gallery) |
npx agy-powerline layout <pills|lines> | Switch layout |
npx agy-powerline caps <style> | Switch the pill shape: round, angled, slanted, flat |
npx agy-powerline doctor | Check the install and explain what's wrong |
npx agy-powerline report | Write a privacy-safe bug report |
npx agy-powerline uninstall [--delete] | Remove it from agy (--delete also removes its files) |
npx agy-powerline render --demo | Print the bar with sample data |
Run any command with --help for its options.
npx agy-powerline init --yes # install the new version's scripts
npx agy-powerline doctor # check everything is up to date
Your settings are kept. Restart agy afterwards.
Run npx agy-powerline doctor first: it checks the install and tells you how to fix what it finds. Common problems and how to report a bug: Troubleshooting.
.git and from your OS. The only link out is g in configure, which opens the GitHub page in your browser.init and uninstall back up settings.json and refuse to edit a file they can't parse.git call for ahead/behind counts, the only commands the bar runs are exec widgets you configure yourself.Full details: SECURITY.md.
Contributions are welcome. Start with CONTRIBUTING.md (setup, architecture, adding a widget or theme) and the Code of Conduct. Open pull requests against develop. Report bugs and ask questions in GitHub issues.
MIT © Wassim AZI
A fast, configurable statusline for Google Antigravity
See the code
A fast, configurable statusline for Google Antigravity's CLI (agy).
See your model, Gemini 5h/7d quotas, context window, git branch and more at a glance. Pick widgets, themes and layout from an interactive editor. One command to install, no dependencies.
You need Node.js 20+ and the Antigravity CLI. Works on Windows, macOS, Linux and WSL (WSL notes).
npx agy-powerline init # install the statusline into agy
npx agy-powerline configure # optional: pick widgets, theme and layout
agy # start Antigravity
init asks before replacing anything and backs up Antigravity's settings.json first. Restart agy once after init. Details: what init does.
For a Nerd Font–free terminal, turn on ASCII mode (i in configure).
npx agy-powerline configure opens an editor with a live preview of your bar. Use ← → to switch between Widgets, Presets, Themes, Layout and Powerline, ↑ ↓ to move, Enter to pick, q to save and quit. The keys for each screen are shown at the bottom; the full list is in Configuration.
Changes apply to a running agy on its next refresh.
Start from a preset, then adjust:
| Preset | Shows |
|---|---|
default | Model, context, git; 5h and 7d quotas with resets on a second row |
compact | One line: short model, tightest quota, context %, git |
workspace | Project, git, agent state, model; context and tightest quota |
limits | Every quota (5h, 7d, third-party), one per row |
full | Everything: session, project and git; context, tokens and cache; both quotas |
| Terminal background | Themes |
|---|---|
| Dark | dark-aurora (default), dark-ocean, dark-ember, dark-forest, dark-neon, dark-mono, dark-nocturne, dark-onyx, dark-metro |
| Light | light-paper, light-sky, light-sunset, light-cream |
| Color-blind safe | colorblind-dark, colorblind-light |
| Your own colors | custom (how) |
Preview them all with npx agy-powerline theme --gallery.
Pills (default): powerline-style capsules. Choose round, angled, slanted or flat shapes, and optionally a blank line between rows.
Lines: the same information as plain colored text.
| Widget | Shows |
|---|---|
model | The model in use |
fiveHourBar, weeklyBar | 5h / 7d quota left as a meter, with a pace marker |
fiveHourPct, weeklyPct | 5h / 7d quota left as a percentage |
fiveHourReset, weeklyReset | Time until the quota resets, or the reset time |
quota | The quota closest to running out, with its reset |
thirdPartyFiveHour, thirdPartyWeekly | Third-party model quotas |
context, contextPct, contextTokens | Context window used: meter, percentage or token counts |
git | Branch, uncommitted changes and ahead/behind |
project, cwd | Project folder, current folder |
agentState, plan, sandbox, artifacts, version | What the agent is doing, your plan, sandbox, artifacts, CLI version |
totalTokens, cacheHit, cacheRead, cacheCreate | Session tokens and prompt cache usage |
ram | Memory used on your machine |
customText, exec | Your own text, or the output of a shell command |
A widget with nothing to show hides itself. Widgets can be recolored, made label-free or given their own alert thresholds: see Configuration.
| Command | What it does |
|---|---|
npx agy-powerline init [--yes] | Install or update the statusline |
npx agy-powerline configure | Open the editor (alias config) |
npx agy-powerline preset <name> | Apply a preset (--list to see them) |
npx agy-powerline theme <name> | Switch theme (--list, --gallery) |
npx agy-powerline layout <pills|lines> | Switch layout |
npx agy-powerline caps <style> | Switch the pill shape: round, angled, slanted, flat |
npx agy-powerline doctor | Check the install and explain what's wrong |
npx agy-powerline report | Write a privacy-safe bug report |
npx agy-powerline uninstall [--delete] | Remove it from agy (--delete also removes its files) |
npx agy-powerline render --demo | Print the bar with sample data |
Run any command with --help for its options.
npx agy-powerline init --yes # install the new version's scripts
npx agy-powerline doctor # check everything is up to date
Your settings are kept. Restart agy afterwards.
Run npx agy-powerline doctor first: it checks the install and tells you how to fix what it finds. Common problems and how to report a bug: Troubleshooting.
.git and from your OS. The only link out is g in configure, which opens the GitHub page in your browser.init and uninstall back up settings.json and refuse to edit a file they can't parse.git call for ahead/behind counts, the only commands the bar runs are exec widgets you configure yourself.Full details: SECURITY.md.
Contributions are welcome. Start with CONTRIBUTING.md (setup, architecture, adding a widget or theme) and the Code of Conduct. Open pull requests against develop. Report bugs and ask questions in GitHub issues.
MIT © Wassim AZI