grav-bar 0.2.0

Fast, zero-dependency, and highly customizable custom status line for the Google Antigravity CLI
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

# 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:

```sh
cargo install grav-bar
```

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

### From Source

Clone the repository and build using Cargo:

```sh
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`:

```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:

```sh
git config core.hooksPath .githooks
```

## License

[MIT](LICENSE)