標準のステータスライン構成要素の切り替え、カスタムスクリプト構成の定義、動的な JSON 状態ペイロードの整形を行います。
概要
ステータスラインは TUI プロンプトパネルの最下部に表示されます。アクティブなエージェントのサイクル、ワークスペース環境、コンテキストトークンウィンドウの使用状況、バックグラウンド実行タスクなどのコンテキストを一目で把握できます。
対話型の切り替え
- プロンプトボックスで
/statuslineと入力し、Enter を押します。 - 対話型の ステータスピッカーパネル（Status Picker Panel） オーバーレイが開きます。
- ↑ / ↓ を使って、特定のメトリクス要素（アクティブなモデル、タスクカウンター、コンテキスト割合など）の表示・非表示を切り替えます。
- Enter を押すと選択を確定して終了します。Esc を押すとキャンセルします。
カスタムステータスラインスクリプト
高度なターミナルレイアウトやカスタムステータスバー表示のために、アクティブなエージェントのメタデータをカスタムスクリプトへ渡すことができます。
設定
~/.gemini/antigravity-cli/settings.json ファイルに statusLine 設定ブロックを追加します。
{
"statusLine": {
"type": "command",
"command": "~/.gemini/antigravity-cli/statusline.sh"
}
}エージェントの状態が変化するたびに、TUI はあなたのコマンドスクリプトを実行し、詳細な状態 JSON ペイロードをスクリプトの stdin に直接パイプし、stdout から整形済みの文字列を読み取って、プロンプトのステータスラインにその結果をレンダリングします。フルの ANSI カラーコードがサポートされます。
利用可能な JSON フィールド
スクリプトにパイプされる JSON ペイロードには、次のトップレベルフィールドが含まれます。
| フィールド | 型 | 説明 |
|---|---|---|
cwd | string | 現在の作業ディレクトリ |
conversation_id | string | 現在の会話 ID |
model | object | アクティブなモデルの id と display_name |
product | string | アプリケーション名（例: antigravity-cli） |
workspace | object | current_dir と project_dir のパス |
version | string | CLI のバージョン文字列 |
plan_tier | string | 認証済みユーザーのサブスクリプションティア |
email | string | 認証済みユーザーの LDAP / メールアドレス |
agent | object | アクティブなエージェントプロファイル名 |
context_window | object | total_input_tokens、total_output_tokens、context_window_size、used_percentage、remaining_percentage、current_usage |
agent_state | string | 現在の状態: idle、thinking、working、tool_use、initializing |
vcs | object | バージョン管理情報: type（git/jj/fig）、branch、client、dirty |
sandbox | object | サンドボックス設定: enabled、allow_network |
subagents | array | アクティブなサブエージェントセッション（name、role、status） |
artifacts | array | 生成されたアーティファクト（uri、status、type） |
pending_input_count | int | キューに入っているユーザーメッセージの数 |
background_tasks | array | 実行中のタスク（name、status、index） |
tool_confirmation_pending | bool | ツール確認ダイアログが表示されているかどうか |
terminal_width | int | 対話型ターミナルのライブな幅 |
JSON ペイロードの例
以下は、ステータスラインスクリプトにパイプされる、サニタイズ済みの典型的な JSON ペイロードです。
{
"cwd": "/home/user/my-project",
"conversation_id": "12345678-abcd-ef01-2345-6789abcdef01",
"model": {
"id": "Gemini",
"display_name": "Gemini"
},
"workspace": {
"current_dir": "/home/user/my-project",
"project_dir": "file:///home/user/my-project"
},
"version": "2026.04.15",
"context_window": {
"total_input_tokens": 88244,
"total_output_tokens": 61074,
"context_window_size": 1048576,
"used_percentage": 8.415603637695312,
"remaining_percentage": 91.58439636230469,
"current_usage": {
"input_tokens": 63382,
"output_tokens": 346,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 20857
}
},
"product": "antigravity-cli",
"agent_state": "idle",
"vcs": {
"type": "git",
"client": "my-project",
"branch": "dev",
"dirty": false
},
"sandbox": {
"enabled": false
},
"plan_tier": "Pro",
"email": "developer@email.com",
"terminal_width": 111
}サンプルスクリプト
完全でレイアウト適応型のスクリプトを、公式の GitHub 上の statusline.sh の例 からダウンロードできます。このスクリプトは状態バッジを描画し、アクティブなブランチを処理し、コンテキストウィンドウの進捗バーを動的に整形します。
スクリプトを ~/.gemini/antigravity-cli/statusline.sh に保存し、実行可能にします。
chmod +x ~/.gemini/antigravity-cli/statusline.sh関連項目
- ターミナルタイトルのカスタマイズ: 動的なウィンドウタイトルを設定します。
- 設定（settings.json）: キーボードホットキーとバッファをカスタマイズします。
- 権限とサンドボックス: 安全なディレクトリ権限を管理します。