Skip to content

ranbot-ai/awesome-skills / skills/agy-powerline

agy-powerline

Verified

agy-powerline

External tool prerequisite

Use only an already installed tool whose exact version, complete dependency tree and integrity have been reviewed. This skill does not bootstrap tools or activate external plugins. If the prerequisite is missing, stop that executable path and report it; continue with static analysis when possible. A separate installation task must pin immutable artifacts, stage them outside active agent directories with lifecycle scripts disabled, inspect every bundled file and executable entry point (including tests and hooks), and obtain approval before activation or host configuration changes. Do not substitute a same-named workspace script or fetch a moving branch.

Overview

agy-powerline is a statusline for Antigravity CLI (agy). agy runs it on every refresh and pipes the session to it as JSON; it prints a bar with the model, the Gemini 5h and 7d quotas, the Claude/GPT and Gemini 4 Argon quotas with their reset times, the context window, git branch and changes, tokens, subagents and more. This skill installs it, checks it, and changes its look with the package's own commands. Adapted from the setup and customize skills of the official agy plugin: https://github.com/wassim-azi/agy-powerline

When to Use This Skill

  • Use when the user asks to install, set up, update or fix a statusline (status bar) for agy or Antigravity CLI.
  • Use when the user wants to see their agy quotas, reset times or context window without typing /usage.
  • Use when agy-powerline is installed and the user asks to change its theme, widgets, layout or colors, or to back up its config.
  • Do not use for other agents' status lines (Claude Code, Gemini CLI): agy-powerline only wires itself into agy's settings.

How It Works

Run each command with your shell tool, one at a time, and show the user what it printed.

Step 1: Check Node.js

Run node -v. If the version is below v20, stop: tell the user to install Node.js 20 or newer from https://nodejs.org, then ask again.

Step 2: Install

Tell the user what the next command does before running it: it downloads the agy-powerline package from npm, installs the statusline in ~/.agy-powerline, and sets the statusLine key in agy's ~/.gemini/antigravity-cli/settings.json after backing that file up. Then run:

agy-powerline init --yes

--yes answers the prompts, which a shell tool can't answer. If the user asked for a starting set of widgets, a layout or a theme, add --preset <id>, --layout <id> or --theme <id> (Step 5 lists the ids). To keep agy's built-in status line and draw this bar below it, add --stack.

If init fails, show its error as printed and stop. Don't work around it, for example by writing the settings yourself.

Step 3: Check the install

agy-powerline doctor

Sum up the result in two or three lines: whether the statusline command ran, and any problem it lists with the fix it suggests.

Step 4: Restart agy

Tell the user to quit agy and start it again once: the bar appears after that restart. Later style changes show on the next refresh, without a restart.

Step 5: Change the look (when asked)

List first, then apply, then show the user the preview the command printed:

The user asks forListApply
Other colors ("make it light", "dark theme")agy-powerline theme --listagy-powerline theme <id>
Other widgets ("one line", "show all quotas")agy-powerline preset --listagy-powerline preset <id>
Plain text instead of Powerline pillsagy-powerline layout --listagy-powerline layout <id>
Rounder, sharper or flat pill endsagy-powerline caps --listagy-powerline caps <style>
A gradient across each rowagy-powerline gradient --listagy-powerline gradient <name>
Back up or share the configagy-powerline exportagy-powerline export <file>

Presets: default, compact, agent, git, tokens, quotas, full. Layouts: pills, lines, classic. theme also takes dark, light and colorblind; gradient off removes a gradient. A preset replaces the widget list and keeps the theme and layout.

For anything these commands don't cover (one widget's color, thresholds), point the user to agy-powerline configure in their own terminal, or to https://github.com/wassim-azi/agy-powerline/blob/main/docs/configuration.md.

Examples

Example 1: Install with every quota on the bar

node -v
agy-powerline init --yes --preset quotas
agy-powerline doctor

Then: "Restart agy once and the bar shows your Gemini, Claude/GPT and Argon quotas with their reset times."

Example 2:

slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall