GitHub - wassim-azi/agy-powerline: Fast, configurable statusline for Google Antigravity CLI (agy): live Gemini, Claude/GPT and Argon quota pacing, git, and an interactive TUI configurator

GitHub

6 min read Original article ↗

English | 简体中文 | 日本語 | Français

CI CodeQL Version Downloads Stars Web Configurator Node Windows macOS Linux License: MIT Dependencies OpenSSF Scorecard OpenSSF Best Practices Mentioned in Awesome Gemini CLI

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.

agy-powerline Pills layout with the dark-ocean theme: agent state, model, plan, project and git; context; 5h and 7d quotas with resets

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.

agy-powerline Pills layout with the light-sky theme on a light terminal, with space between rows

Lines: the same information as plain colored text.

agy-powerline Lines layout with the dark-ocean theme on a dark terminal agy-powerline Lines layout with the light-sky theme on a light terminal

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 .git and from your OS. The only link out is g in configure, which opens the GitHub page in your browser.
  • Your settings are safe. init and uninstall back up settings.json and refuse to edit a file they can't parse.
  • Nothing runs unless you add it. Apart from quick git calls for ahead/behind counts and for the file and line counts of the git widgets you add, the only commands the bar runs are exec widgets 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
Yatharth Soni
Danny Ward
Danny Ward
Yusuf Orçan
Yusuf Orçan
Yusuf Efe
Yusuf Efe
hiyouwhatsapp
hiyouwhatsapp
dharamdan01
dharamdan01

If agy-powerline is useful to you, a ⭐ helps other agy users find it.

Star History

Star History Chart

License

MIT © Wassim AZI