gitwtfhub

wtf is agy-statusline?

ranteck/agy-statusline — explained in plain English

Analysis updated 2026-05-18

13ShellAudience · developerComplexity · 1/5Setup · easy

TL;DR

A shell script that adds a status line to the Antigravity CLI showing the active AI model, context usage, git branch, and remaining quota.

Mindmap

Mindmap is still cooking. Refresh in a few.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Show the active model and context window usage while using the Antigravity CLI.

REASON 2

See your current git branch and uncommitted-changes status right in the terminal prompt.

REASON 3

Track remaining five-hour and weekly usage quota for Claude or Gemini models.

REASON 4

Toggle a custom status line on or off inside the Antigravity CLI.

What's in the stack?

Shelljqgit

How it stacks up

ranteck/agy-statuslineadukecoins/codewatchfrichxi/zanai-writing-skill
Stars131313
LanguageShellShellShell
Setup difficultyeasymoderateeasy
Complexity1/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires jq, git, and the Antigravity CLI already installed and configured.

Wtf does this do

agy-statusline is a small shell script project that adds a custom status line to the Antigravity CLI, a command-line tool known by its short name agy. Instead of a plain prompt, it shows a compact line of information at the bottom of the terminal while you work, covering which AI model is currently active, how much of that session's context window has been used, your working directory and git branch, your account plan, and how much of your usage quota remains. The status line displays two kinds of quota, a five-hour rolling limit and a weekly limit, each shown as a small set of filled and empty circles alongside a percentage and a reset time. It automatically figures out whether to show Claude or Gemini quota based on whichever model is active, so there is nothing to configure by hand for that part. Using it requires three things already installed: jq for parsing JSON, git for reading branch information, and the Antigravity CLI itself already set up. Installation is done by cloning the repository and running an install script, which copies the status line script into the Antigravity CLI's configuration folder and registers it in that tool's settings file. A separate uninstall script removes the entry and restores whatever status line, if any, was configured before. Under the hood, the Antigravity CLI runs whatever command is set as the statusLine in its settings, feeding it the current session state as JSON through standard input, and the script reads that JSON and prints back colored text for the terminal to display. The status line can also be turned on or off at any time from inside the CLI using a slash command.

Yoink these prompts

Prompt 1
Help me install agy-statusline using its bin/install.sh script.
Prompt 2
Explain what each field in the agy-statusline output means.
Prompt 3
Show me how agy-statusline reads session state as JSON from stdin.
Prompt 4
Walk me through uninstalling agy-statusline and restoring my previous status line.

Frequently asked questions

wtf is agy-statusline?

A shell script that adds a status line to the Antigravity CLI showing the active AI model, context usage, git branch, and remaining quota.

What language is agy-statusline written in?

Mainly Shell. The stack also includes Shell, jq, git.

How hard is agy-statusline to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is agy-statusline for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.