# agy-powerline > A configurable statusline dashboard for Google Antigravity CLI (`agy`) supporting Google Gemini (Hydrogen, Neon, Argon, Carbon, Flash) and Anthropic (Claude, Sonnet) models. Tracks quotas with pace markers and run-out forecasts, context window with compaction limits, session and 30-day tokens, estimated spend with budget alerts, agent state, subagents and queued messages, git details with clickable terminal links and fish-style shortening, across 22 WCAG AA themes, 3 layouts, 7 bar languages, and 16 bar-wide settings. Requires Node.js 20+ (Node 22.13+ for cross-conversation token totals via `node:sqlite`); has no runtime dependencies, no network calls, and no telemetry. ## Capabilities - **Quota pace & forecasts:** Pace markers compare quota consumption against elapsed 5h and 7d window time across Gemini, Anthropic (Claude, Sonnet), and Argon weekly buckets. Optional `paceDelta` shows points ahead (`⇡`) or behind (`⇣`) an even pace, and `forecast` estimates when quota runs out at the current rate. Display quotas as remaining or used (`quotaMode`), optionally zero 5h when 7d is empty (`zeroFiveHourWhenWeeklyEmpty`), and keep disabled 3P 5h visible (`showDisabled`). - **Context, tokens & cost:** Track context window usage against the full window or a soft `compactionLimit` (e.g. `256000`). Monitor session tokens (`totalTokens`, with input/output `split`), prompt cache (`cacheRead`, `cacheCreate`, `cacheHit`), cross-conversation totals (`tokensToday`, `tokensWeek`, `tokensMonth`, read read-only from agy's local SQLite databases on Node 22.13+), and estimated USD spend (`cost`, with optional subagent `split`) with `budget` alerts (`warn`/`crit` colors and `blink`). - **Git & clickable workspace links:** Show branch, dirty state, ongoing git operations (`REBASE`, `MERGING`, `CHERRY-PICKING`, `REVERTING`, `BISECTING`), ahead/behind counts, line changes (`gitChanges`), file counts (`gitFiles`), commit SHA (`gitSha`), stashes (`gitStash`), and linked worktree (`gitWorktree`). Optional `link` creates clickable OSC 8 hyperlinks to folders (`file`, `vscode`, `cursor`, `zed`) and remote branches/commits; `fish` shortens parent directories (`~/D/r/app`) and branch prefixes (`f/a/oauth-login`). - **Agent, tasks & environment:** Show active non-default `agent`, `agentState` (including pending tool confirmation), running `tasks` (subagents and background tasks), `queue` (queued user messages), `mode` (approval and Vim modes), `sandbox`, `artifacts`, `env` variables (zero subprocesses; secret-like names blocked), and `exec` shell commands (global install config only). - **Interactive editor & Settings:** `npx agy-powerline` installs or updates the bar and launches a full-screen TUI editor with six tabs — Widgets (`w`), Presets (`o`), Themes (`t`), Layout (`l`), Powerline (`p`), and Settings (`i`) — plus live scenario switching (`,` `.`: Normal, Near limits, Agent & modes), simulated terminal widths (`-` `+`: 60–120 columns or full), `/` search filtering, and mouse support. The [browser configurator](https://agy-powerline.com/configure/) mirrors the editor with full Settings parity and shareable URLs. - **Themes, layouts & localization:** 22 WCAG AA themes (dark, light, color-blind safe) plus `custom`, 8 row gradients (`aurora`, `sunset`, `ocean`, `forest`, `neon`, `candy`, `rainbow`, `mono`) or custom hex stops, 9 meter styles (`pips`, `cells`, `dots`, `blocks`, `shade`, `squares`, `braille`, `rings`, `ramp`), 7 bar languages (`en`, `fr`, `es`, `ja`, `zh-CN`, `ko`, `de`), `ascii` mode, `maxWidth`, `alignment`, and `overflow` (`fit` or `wrap`). ## Install - `npx agy-powerline` installs (or updates outdated scripts) and opens the interactive TUI configurator in a terminal. - `npx agy-powerline init --yes` installs the statusline non-interactively and wires it into Antigravity settings. - Restart `agy` once after first install; `npx agy-powerline doctor` checks the installation. ## Commands - `npx agy-powerline` — Install (if needed), update outdated scripts, and open the editor in an interactive terminal (run `--help` for the command list). - `npx agy-powerline init [--yes]` — Install or update the statusline. - `npx agy-powerline configure` — Open the editor (deprecated compatibility alias for `npx agy-powerline`). - `npx agy-powerline preset ` — Apply a preset (`--list` to see them). - `npx agy-powerline theme ` — Switch theme (`--list`, `--gallery`). - `npx agy-powerline gradient ` — Color rows with a gradient (`--list`, `off`); presets: `aurora`, `sunset`, `ocean`, `forest`, `neon`, `candy`, `rainbow`, `mono`. - `npx agy-powerline layout ` — Switch layout. - `npx agy-powerline caps