English | 简体中文 | 日本語 | Français
A fast, configurable statusline for Google Antigravity's CLI (agy).
See your model, Gemini 5h/7d, Claude/GPT and Argon 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.
Install
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
On a first install init asks for a preset, a layout and a theme, with a preview of each; add --yes to skip the questions. It asks before replacing anything and backs up Antigravity's settings.json first. Restart agy once after init. Details: what init does.
Install from inside agy
agy-powerline is also an agy plugin. Add it, then run its setup skill in an agy session; it runs init and doctor for you:
agy plugin install https://github.com/wassim-azi/agy-powerline
/agy-powerline-setup
Restart agy once afterwards. Details: the plugin route.
Or paste this into an agy session.
Install the agy-powerline statusline: run `npx agy-powerline init --yes`, then tell me to restart agy.
--yes skips the prompts, which agy can't answer, and replaces any existing statusLine after backing up settings.json.
For a Nerd Font–free terminal, turn on ASCII mode (i in configure).
Customize
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.
Prefer a browser? Build your bar in the browser with live previews, then download or import it.
Changes apply to a running agy on its next refresh.
Presets
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, tightest quota and mode |
limits |
Every quota (5h, 7d, third-party, Argon), one per row |
full |
Everything: session, project and git; context, tokens and cache; both quotas |
Themes
| Terminal background | Themes |
|---|---|
| Dark | dark-aurora (default), dark-ocean, dark-ember, dark-forest, dark-neon, dark-mono, dark-nocturne, dark-onyx, dark-metro, dark-macchiato |
| Light | light-paper, light-sky, light-sunset, light-cream |
| Color-blind safe | colorblind-dark, colorblind-light |
| Your own colors | custom (how) |
Preview them all in the theme gallery or with npx agy-powerline theme --gallery. For one color sweep across each row, add a gradient: npx agy-powerline gradient <name> with aurora, sunset, ocean, forest, neon, candy, rainbow, mono or your own colors (how).
Layouts
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.
Widgets
| 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 |
argonWeekly, argonReset |
Gemini 4 Argon's own weekly quota (Google AI Pro) and its reset |
context, contextPct, contextTokens |
Context window used: meter, percentage or token counts |
git |
Branch, uncommitted changes and ahead/behind |
gitChanges, gitFiles, gitSha, gitStash, gitWorktree |
Lines added and removed, staged/modified/untracked/conflicted files, commit ID, stashes, linked worktree |
project, cwd |
Project folder, current folder |
agentState, plan, sandbox, artifacts, version |
What the agent is doing, your plan, sandbox, artifacts, CLI version |
tasks |
Running subagents and background tasks |
mode |
Approval mode (e.g. accept-edits) and Vim mode |
title |
The conversation's title |
totalTokens, cacheHit, cacheRead, cacheCreate |
Session tokens and prompt cache usage |
tokensToday, tokensWeek |
Tokens used today and over the last 7 days, all conversations (Node 22.13+) |
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.
Commands
| 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 gradient <name> |
Color each row with a gradient (--list, off) |
npx agy-powerline layout <pills|lines> |
Switch layout |
npx agy-powerline caps <style> |
Switch the pill shape: round, angled, slanted, flat |
npx agy-powerline export [file] |
Save your config to a file, to back it up or share it |
npx agy-powerline import <file> |
Load a config, after showing what changes (--merge) |
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.
Updating
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.
Troubleshooting
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.
Privacy and security
- No network calls, no telemetry. Everything comes from the data agy passes to the bar, from
.gitand from your OS. The only link out isginconfigure, which opens the GitHub page in your browser. - Your settings are safe.
initanduninstallback upsettings.jsonand refuse to edit a file they can't parse. - Nothing runs unless you add it. Apart from quick
gitcalls for ahead/behind counts and for the file and line counts of the git widgets you add, the only commands the bar runs areexecwidgets you configure yourself. - Zero runtime dependencies, published from CI with npm provenance.
Full details: SECURITY.md.
Contributing
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 in GitHub issues or share ideas and feedback in Discussions.
Thanks to everyone who has contributed:
Yatharth Soni |
Danny Ward |
Yusuf Orçan |
Yusuf Efe |
hiyouwhatsapp |
dharamdan01 |
If agy-powerline is useful to you, a ⭐ helps other agy users find it.
Star History
License
MIT © Wassim AZI



