https://github.com/weby-homelab/antigravity-cli-statusline
An advanced, responsive, and high-information statusline plugin for Antigravity CLI
https://github.com/weby-homelab/antigravity-cli-statusline
ai-agents antigravity antigravity-cli antigravity-extension cli devtools homelab statusline terminal terminal-ui tui
Last synced: 14 days ago
JSON representation
An advanced, responsive, and high-information statusline plugin for Antigravity CLI
- Host: GitHub
- URL: https://github.com/weby-homelab/antigravity-cli-statusline
- Owner: weby-homelab
- Created: 2026-06-15T12:36:45.000Z (20 days ago)
- Default Branch: main
- Last Pushed: 2026-06-16T12:48:43.000Z (19 days ago)
- Last Synced: 2026-06-18T17:30:54.206Z (17 days ago)
- Topics: ai-agents, antigravity, antigravity-cli, antigravity-extension, cli, devtools, homelab, statusline, terminal, terminal-ui, tui
- Language: Shell
- Homepage: https://Antigravity-CLI-STATUSLINE.srvrs.top
- Size: 253 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🚀 Antigravity CLI Statusline (Max Edition)
An advanced, responsive, and high-information statusline plugin for the **[Antigravity CLI (Community Fork)](https://github.com/weby-homelab/antigravity-cli)** (`agy`). It features multi-layout adapting to your terminal width, real-time Git status tracking, token counting, active model quotas, and sandbox badges.
---
## 🎨 Layout Showcase
### 👑 Ultra Layout (Full Telemetry)
The ultimate high-information layout displaying all telemetry fields: system metrics, Git status, active subagents, background tasks, model quotas, and power/battery state in a single visual dashboard.
### 🖥️ Wide Layout (Terminal width $\ge$ 180 chars)
Provides a rich, single-row layout displaying all developer telemetry and active quotas side-by-side.
### 📱 Medium Layout (Terminal width $\ge$ 90 chars)
Wraps status into a clean two-line boxed block to avoid command output line wrap.
---
## 🎨 Compatibility Mode (Classic Icons)
If your terminal does not support Nerd Fonts (e.g., ChromeOS Terminal, Emacs, or standard TTYs), you can run the statusline in **Classic Icon Mode**. This mode replaces advanced glyphs with standard Unicode symbols (`●`, `◆`, `⚙`, `🔧`, etc.) and plain text labels to ensure clean rendering.
To enable it, simply append `--classic` (or `--no-nerdfont` / `--compatibility`) to the command parameter in your `settings.json`:
### 🐧 macOS / Linux (`~/.gemini/antigravity-cli/settings.json`)
```json
{
"statusLine": {
"type": "",
"command": "/home/user/.antigravity/statusline.sh --classic",
"enabled": true
}
}
```
### 🪟 Windows (`%USERPROFILE%\.gemini\antigravity-cli\settings.json`)
```json
{
"statusLine": {
"type": "",
"command": "powershell -NoProfile -ExecutionPolicy Bypass -File \"C:/Users/user/.antigravity/statusline.ps1\" --classic",
"enabled": true
}
}
```
---
## ✨ Features
- **Responsive Design:** Automatically switches layouts (Wide, Medium, Small) depending on terminal width (`terminal_width`) to avoid messy line wrapping.
- **Smart Git Tracking:** Queries the Git binary (`git -C`) directly to get real-time branch status and dirty states, bypassing cached session details.
- **Dynamic Quota Swapping:** Automatically detects the current LLM model (Gemini vs. 3rd-party models) and switches to display the correct active quotas (`gemini-5h` & `gemini-weekly` or `3p-5h` & `3p-weekly`) along with countdowns to quota reset.
- **Context & Token Metres:** Displays a visual 20-segment context window bar with percentage, and displays total input/output tokens in a human-readable (`K`, `M`) format.
- **Current Turn Token Usage:** Tracks the input/output tokens processed during the last turn (e.g. `turn: +40.5K/318`).
- **Sandbox Network Badges:** Displays whether the execution sandbox is `ON (net)`, `ON (no-net)`, or `OFF`.
- **Background Actions Tracker:** Live metrics showing active subagents count (``) and running background tasks (``).
- **CLI & Session Metadata:** Displays the current `agy` CLI version, subscription tier (e.g. `Google AI Pro`), and logged-in account email.
- **Resilient Power & Host Tracking:** Live display of the host machine's name, Tailscale connection IP, and mains/battery status with capacity metrics (e.g. `🔌 AC` or `🔋 85%`) to track blackout states.
---
## 📥 Installation
> [!NOTE]
> This statusline is already configured and enabled by default when you install the community-hardened **[Antigravity CLI](https://github.com/weby-homelab/antigravity-cli)**. Use this manual installation only if you are using the upstream CLI version or want to reinstall it separately.
> [!WARNING]
> Do **NOT** run the installation commands with `sudo`. The statusline installs locally in your home directory (`~/.antigravity` and `~/.gemini/`). Running with `sudo` will cause file permission issues for your user account.
Choose the installation command for your operating system:
### 🐧 macOS / Linux
**One-liner (curl):**
```bash
curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli-statusline/main/install.sh | bash
```
**One-liner (wget):**
```bash
wget -qO- https://raw.githubusercontent.com/weby-homelab/antigravity-cli-statusline/main/install.sh | bash
```
**Manual Installation:**
1. Clone this repository:
```bash
git clone https://github.com/weby-homelab/antigravity-cli-statusline.git
```
2. Navigate to the directory, make the installer executable, and run it:
```bash
cd antigravity-cli-statusline
chmod +x install.sh
./install.sh
```
---
### 🪟 Windows (PowerShell)
**One-liner (PowerShell WebRequest):**
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -Command "iex (irm https://raw.githubusercontent.com/weby-homelab/antigravity-cli-statusline/main/install.ps1)"
```
**One-liner (curl on Windows):**
If you have curl.exe installed on Windows, you can download and run the installer in one line:
```powershell
curl -fsSL https://raw.githubusercontent.com/weby-homelab/antigravity-cli-statusline/main/install.ps1 | powershell -NoProfile -ExecutionPolicy Bypass -Command -
```
**Manual Installation:**
1. Clone this repository:
```powershell
git clone https://github.com/weby-homelab/antigravity-cli-statusline.git
```
2. Navigate to the directory and execute:
```powershell
cd antigravity-cli-statusline
Powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1
```
---
## 🗑️ Uninstallation
The installation script places a dedicated uninstaller script in your permanent `~/.antigravity` folder. You can run it directly from anywhere without needing the original git clone directory.
### 🐧 macOS / Linux
```bash
~/.antigravity/uninstall.sh
```
### 🪟 Windows (PowerShell)
```powershell
Powershell -NoProfile -ExecutionPolicy Bypass -File $HOME\.antigravity\uninstall.ps1
```
---
## ⚙️ Configuration & File Structure
Here is the file structure installed by the automated setup scripts on each platform, along with their related configuration paths.
### 🐧 macOS / Linux File Structure
```text
~ (User Home)
├── .antigravity/ # Installation folder
│ ├── statusline.sh # Statusline logic script
│ └── uninstall.sh # Uninstallation helper script
└── .gemini/
└── antigravity-cli/
└── settings.json # Antigravity CLI configuration
```
Your `~/.gemini/antigravity-cli/settings.json` will be configured as follows:
```json
{
"statusLine": {
"type": "",
"command": "/home/user/.antigravity/statusline.sh",
"enabled": true
}
}
```
### 🪟 Windows File Structure
```text
C:\Users\ (User Profile)
├── .antigravity\ # Installation folder
│ ├── statusline.ps1 # Statusline PowerShell script
│ └── uninstall.ps1 # Uninstallation helper script
└── .gemini\
└── antigravity-cli\
└── settings.json # Antigravity CLI configuration
```
Your `%USERPROFILE%\.gemini\antigravity-cli\settings.json` will be configured as follows:
```json
{
"statusLine": {
"type": "",
"command": "powershell -NoProfile -ExecutionPolicy Bypass -File \"C:/Users/user/.antigravity/statusline.ps1\"",
"enabled": true
}
}
```
---
## 📝 Important Notes & Release History
### 🚀 Release v0.1.3 (June 16, 2026)
- **One-liner Web Installation**: Added full support for direct internet-based installation using `curl` or `wget` (without cloning the repository locally) for Linux, macOS, and Windows.
- **Sudo Safety Check**: Added an active check to block execution when run with `sudo` or as `root` via `sudo` on Linux/macOS to protect local user home directory permissions.
### 🚀 Release v0.1.2 (June 15, 2026)
- **Classic Compatibility Mode**: Added support for terminals without Nerd Fonts (e.g. ChromeOS Terminal, Emacs, legacy TTYs). You can activate it by adding `--classic`, `--no-nerdfont`, or `--compatibility` arguments to the `command` field in your `settings.json`.
- **Robust Quota Detection & Auto-Hide**: Fixed issues where model quotas failed to show or displayed empty progress bars when using custom/third-party model names. The script now dynamically selects the first active quota and hides the quota block completely if no quota limits are available (`-1` or null).
- **PowerShell Compatibility**: Ported all classic-mode and quota detection enhancements to Windows (`statusline.ps1`).
---
Built in Ukraine under air raid sirens & blackouts ⚡
© 2026 Weby Homelab