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 ⏳ Xh Ym (if >= 1h) or ⌛ 0h Ym (if < 1h) for the 5-hour quota reset time.
• 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:

<skill_dir>/scripts/install.sh