starship-antigravity
Starship-antigravity statusline setup wizard with customizable palettes for Google Antigravity
Open source Open in the app JSON README (API)
About
Starship-antigravity statusline setup wizard with customizable palettes for Google Antigravity
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- mastacheata
- Origin
- gemini
- Category
- ferramentas
- Version
- 1.0.0
- Last push
- 2026-08-15T15:16:21Z
- Repository state
- ativo
- Language
- Shell
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
mastacheata/starship-antigravity
README
# starship-antigravity
[](https://github.com/martinemde/starship-claude/actions/workflows/ci.yml)
_Use [Starship](https://starship.rs) for your [Google Antigravity](https://antigravity.google) status line._
## Quick Start
Run the setup wizard in Antigravity:
```
/starship
```
The wizard will guide you through setup:
1. Check if starship is installed (offers to install if missing)
2. Detect existing configuration and ask what to do
3. Ask about Nerd Font support
4. Let you choose a color palette
5. Let you choose a prompt style
6. Install the script and generate your config
7. Update your Google Antigravity settings (`~/.gemini/settings.json`)
8. Verify everything works
## Manual Install
You'll need [starship](https://starship.rs/#quick-install) to render the statusline:
```bash
# If you don't already have starship...
curl -sS https://starship.rs/install.sh | sh
```
You'll probably want a [Nerd Font](https://www.nerdfonts.com/) (optional) for icons.
When you're ready to install, run these in your terminal:
```bash
# Download the script from this repository
mkdir -p ~/.local/bin
curl -fsSL https://raw.githubusercontent.com/martinemde/starship-claude/main/plugin/bin/starship-antigravity \
-o ~/.local/bin/starship-antigravity && chmod +x ~/.local/bin/starship-antigravity
# Get the config file that you can customize
mkdir -p ~/.gemini
curl -fsSL https://raw.githubusercontent.com/martinemde/starship-claude/main/plugin/templates/minimal-nerd.toml \
-o ~/.gemini/starship.toml
```
Add the statusline in your Google Antigravity settings (`~/.gemini/settings.json`):
```jsonc
{
// ... other settings
"statusLine": {
"type": "command",
"command": "~/.local/bin/starship-antigravity"
}
}
```
Run it directly to test it out:
```sh
./plugin/bin/starship-antigravity < test/fixtures/agy_session.json
```
## Context Window Progress Bar
Show progress bars for context usage percentages in terminals like Ghostty.
We use [Dex Horthy's "dumb zone" (video)][dumb-zone] to start warning at 40%.
- Progress bar scales for 80% compaction.
- 0-40%: Normal - You're good.
- 40-60%: Warning - Reset if it's not going well.
- 60%+: Error - Compacting soon...
[dumb-zone]: https://www.youtube.com/watch?v=rmvDxxNubIg 'YouTube: No Vibes Allowed: Solving Hard Problems in Complex Codebases – Dex Horthy, HumanLayer'
### Customize
Add options in `~/.gemini/settings.json` if you want to customize behavior:
```jsonc
{
"statusLine": {
"type": "command",
"command": "~/.local/bin/starship-antigravity --config ~/.gemini/starship.toml"
}
}
```
Available flags:
- `--config PATH` - Custom Starship config file location
- `--no-progress` - Disable terminal context progress bar
### Available Environment Variables
The statusline script exports `AGY_*` environment variables for use in your `starship.toml`:
- `AGY_MODEL` - Short model display name
- `AGY_MODEL_NERD` - Model display name with Nerd Font icon
- `AGY_CONTEXT` - Context window usage percentage (e.g. `14%`)
- `AGY_QUOTA` - Formatted quota remaining percentage (e.g. `93.8%`)
- `AGY_SUMMARY` - Session summary
- `AGY_SESSION_ID` - Session UUID
- `AGY_CONVERSATION_ID` - Conversation UUID
- `AGY_TRANSCRIPT_PATH` - Path to session transcript JSONL
- `AGY_CWD` - Current working directory
- `AGY_VERSION` - Antigravity version
- `AGY_PRODUCT` - Product name ("antigravity")
- `AGY_AGENT_STATE` - Agent state ("idle", "thinking", etc.)
- `AGY_VCS_BRANCH` - Git branch name
### Running Tests
Install BATS and run tests:
```bash
# Run all tests
npx -y bats test/
```
## License
MIT License © 2026 Martin Emde