whatisgithub

What is agy-statusline?

ranteck/agy-statusline — explained in plain English

Analysis updated 2026-05-18

13ShellAudience · developerComplexity · 1/5Setup · easy

In one sentence

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

A visual breakdown will appear here once this repo is fully enriched.

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

Shelljqgit

How does it compare?

ranteck/agy-statuslineadukecoins/codewatchdevdacian/touchstone
Stars131313
LanguageShellShellShell
Setup difficultyeasymoderateeasy
Complexity1/52/52/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

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

So what is it?

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.

Copy-paste 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

What 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.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.