grav-bar 0.2.0

Fast, zero-dependency, and highly customizable custom status line for the Google Antigravity CLI
grav-bar-0.2.0 is not a library.

grav-bar

Fast and zero-dependency custom status line built in Rust for the Google Antigravity CLI (agy).

Features

  • Fast: Written in pure Rust with zero external dependencies. It completes execution in <1ms!
  • Dynamic Resizing: Automatically shortens the file path and model names when you resize your terminal window to prevent line wrapping.
  • Quota Parsing: Automatically parses standard quotas for both Google Gemini and 3rd Party (3p) models.
  • Right Aligned Sections: Calculates terminal width and dynamically aligns agent status and model type to the right edge.

Installation

From crates.io

The easiest way to install grav-bar is directly from crates.io using Cargo:

cargo install grav-bar

Note: This will install the binary to ~/.cargo/bin/grav-bar.

From Source

Clone the repository and build using Cargo:

git clone https://github.com/AABelkhiria/grav-bar.git
cd grav-bar
cargo build --release
cp target/release/grav-bar ~/.local/bin/grav-bar

Configuration

To use grav-bar, configure your Antigravity CLI to pipe its UI JSON payload to the binary. Add the following to your ~/.gemini/antigravity-cli/settings.json:

{
  "ui": {
    "status_line": {
      "command": "/Users/YOUR_USER/.cargo/bin/grav-bar"
    }
  }
}

(Note: If you built from source, use /Users/YOUR_USER/.local/bin/grav-bar instead.)

How It Works

grav-bar works by ingesting a raw JSON payload from stdin every time the agy CLI refreshes its state. It uses manual string parsing to cleanly and efficiently extract only the keys needed (e.g., cwd, display_name, terminal_width) without the overhead of parsing the entire JSON DOM into memory.

Contributing

Pull requests are welcome!

Git Hooks

We use a shared pre-commit hook to automatically format and lint the code before each commit. After cloning the repository, please configure your local Git to use the shared hooks directory by running:

git config core.hooksPath .githooks

License

MIT