# Antigravity CLI Statusline

> Customizes the Antigravity CLI status bar to show folder icons, home-abbreviated current working directory, model name, and 5H/7D token quota usage with live refresh countdown.

- Skill: `hankunpeng/antigravity-cli-statusline` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add hankunpeng/antigravity-cli-statusline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hankunpeng/antigravity-cli-statusline/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: hankunpeng (https://skillmd.com/u/hankunpeng)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hankunpeng/antigravity-cli-statusline

---


# Antigravity CLI Custom Statusline Skill

This skill allows configuring, installing, or updating the custom status bar configuration for the Antigravity CLI (`agy`).

## Features

- **Preserve Native Status Line (Line 1)**: Renders the default CLI status line on the first line (agent state, active model, and context window token usage) with perfect alignment.
- **Custom Telemetry Additions (Line 2)**: Displays custom metrics below the native status line: folder icon, home-abbreviated current working directory, 5H/7D token quota usage, and live refresh countdown.
- **Double-line / Single-line Auto Layout**: For custom telemetry additions (Line 2), automatically fits path and quotas into a single line if terminal width permits, otherwise wraps custom additions to a clean secondary line.
- **Directory Emoji**: Prepend `📂` to the leftmost side of the path.
- **Token Quota Display**: Displays 5H (5-hour) and 7D (weekly) remaining fraction percentages.
- **Live Refresh Countdown**: Displays live refresh countdowns (`⏳ Xh Ym` / `⏳ Xd Yh` or `⌛ 0h Ym`) for both 5-hour (5H) and weekly (7D) quota reset times.
- **Auto-Refresh**: Configures the status line to update every 60 seconds.

## Files Included

- `scripts/statusline.sh`: The shell script executed by `agy` to render the status line.
- `scripts/install.sh`: Helper script to automatically copy `statusline.sh` to the app data directory, grant execution permissions, and update `settings.json`.

## Usage

Run the installation helper script from this skill folder to install or update:
```bash
<skill_dir>/scripts/install.sh
```