The status line is positioned at the bottom of the TUI prompt panel. It provides at-a-glance context regarding active agent cycles, workspace environments, context token window usages, and background execution tasks.

Custom status line scriptinglink

For advanced terminal layouts or custom status bar displays, you can route active agent metadata into a custom script.

Configurationlink

Add a statusLine configuration block to your ~/.gemini/antigravity-cli/settings.json file:

{
  "statusLine": {
    "type": "command",
    "command": "~/.gemini/antigravity-cli/statusline.sh"
  }
}

Whenever the agent state changes, the TUI executes your command script, pipes a detailed state JSON payload directly to the script's stdin, reads your formatted string from stdout, and renders the result in the prompt's status line. Full ANSI color codes are supported.

Available JSON fieldslink

The JSON payload piped to your script contains the following top-level fields:

Field	Type	Description
`cwd`	string	Current working directory when the CLI was launched.
`session_id`	string	Backward-compatibility alias for `conversation_id`.
`conversation_id`	string	Current unique conversation ID.
`transcript_path`	string	Absolute path to the active conversation transcript log file (optional).
`model`	object	Contains `id` and `display_name` of the active model.
`workspace`	object	Contains `current_dir` and `project_dir` paths.
`version`	string	CLI version string.
`context_window`	object	Contains token usage details: `total_input_tokens`, `total_output_tokens`, `context_window_size`, `used_percentage`, `remaining_percentage`, and `current_usage` sub-object.
`exceeds_200k_tokens`	bool	True if the conversation context has exceeded 200k tokens (null before first API call).
`product`	string	Application name (e.g., `antigravity`).
`quota`	object	Maps model/bucket IDs to their quota status, containing `remaining_fraction`, `reset_time`, and `reset_in_seconds` (optional).
`agent_state`	string	Current state: `idle`, `thinking`, `working`, `tool_use`, `initializing`.
`vcs`	object	Version control info: `type` (git/jj/hg), `branch`, `client`, `dirty` (optional).
`sandbox`	object	Sandbox configuration: `enabled`, `allow_network` (optional).
`artifact_count`	int	Number of artifacts produced in the conversation.
`plan_tier`	string	Subscription tier of the authenticated user (optional).
`email`	string	Email/LDAP of the authenticated user.
`pending_input_count`	int	Number of queued user messages.
`tool_confirmation_pending`	bool	True when a tool confirmation dialog is showing.
`task_count`	int	Number of running background tasks.
`terminal_width`	int	Live width of the interactive terminal.
`execution_mode`	string	Current active prompt execution mode (e.g., `planning`, `fast`).

JSON payload examplelink

Here is a fully sanitized, typical JSON payload piped to your status line script:

{
  "cwd": "/home/user/my-project",
  "session_id": "12345678-abcd-ef01-2345-6789abcdef01",
  "conversation_id": "12345678-abcd-ef01-2345-6789abcdef01",
  "transcript_path": "/home/user/.gemini/antigravity/brain/12345678-abcd-ef01-2345-6789abcdef01/.system_generated/logs/transcript.jsonl",
  "model": {
    "id": "Gemini 3.5 Flash (High)",
    "display_name": "Gemini 3.5 Flash (High)"
  },
  "workspace": {
    "current_dir": "/home/user/my-project",
    "project_dir": "/home/user/my-project"
  },
  "version": "1.0.13",
  "context_window": {
    "total_input_tokens": 88244,
    "total_output_tokens": 61074,
    "context_window_size": 1048576,
    "used_percentage": 14.24,
    "remaining_percentage": 85.76,
    "current_usage": {
      "input_tokens": 63382,
      "output_tokens": 346,
      "cache_creation_input_tokens": 0,
      "cache_read_input_tokens": 20857
    }
  },
  "exceeds_200k_tokens": false,
  "product": "antigravity",
  "quota": {
    "gemini-weekly": {
      "remaining_fraction": 0.9378,
      "reset_time": "2026-07-06T07:50:32Z",
      "reset_in_seconds": 560580
    }
  },
  "agent_state": "idle",
  "vcs": {
    "type": "git",
    "branch": "main",
    "dirty": false
  },
  "sandbox": {
    "enabled": false
  },
  "artifact_count": 2,
  "plan_tier": "Pro",
  "email": "developer@email.com",
  "task_count": 1,
  "terminal_width": 111,
  "execution_mode": "planning"
}

Example scriptlink

You can download a complete, layout-adaptive script from the official statusline.sh example on GitHub. This script renders state badges, handles active branches, and formats context window progress bars dynamically.

Save the script to ~/.gemini/antigravity-cli/statusline.sh and make it executable:

chmod +x ~/.gemini/antigravity-cli/statusline.sh

Status line customizationlink

Overviewlink

Custom status line scriptinglink

Configurationlink

Available JSON fieldslink

JSON payload examplelink

Example scriptlink

See alsolink