---
url: /antigravity/cli-title.md
description: 配置动态窗口标题、映射自定义脚本配置，并格式化 JSON 状态输出以自定义终端标头。
---

# 自定义终端标题 (Terminal Title Customization)

配置动态窗口标题、映射自定义脚本配置，并格式化 JSON 状态输出以自定义终端标头。

## 概述 (Overview)

终端窗口标题功能在您的终端模拟器的标题栏中显示 Agent 详细信息、当前工作空间的基准名称 (basename) 以及活跃对话参数。这使您即使在终端窗口最小化或失去焦点时，也能监控 Agent 的进度。

## 交互式切换 (Interactive Toggling)

语法：

```text
/title [on|off]
```

* 在提示框中输入 `/title` 并按 `Enter` 键即可开启或关闭该功能。
* 输入 `/title on` 或 `/title off` 可以显式地设置状态。

## 自定义标题脚本 (Custom Title Scripting)

若要进行自定义的窗口标题格式化，您可以将活跃的 TUI 状态详细信息路由到自定义 Shell 脚本中。

### 配置

将 `title` 配置块添加到您的 `~/.gemini/antigravity-cli/settings.json` 文件中：

```json
{
  "title": {
    "type": "command",
    "command": "~/.gemini/antigravity-cli/title.sh"
  }
}
```

每当 Agent 状态发生变化时，TUI 都会执行您的命令脚本，将详细的状态 JSON 数据负载直接通过管道传输到该脚本的 `stdin`（标准输入），从 `stdout`（标准输出）读取您格式化后的字符串，并更新您的终端窗口标题。不可打印字符和 ANSI 转义序列在渲染之前会被自动剥离。

### JSON 状态数据负载模式

该 JSON 状态数据负载与发送到自定义状态栏脚本的负载完全相同。它包含代表 `cwd`、`conversation_id`、`agent_state`、版本控制系统 `vcs` 详细信息等的详细属性。请参阅“自定义状态栏 (Status Line Schema)”以获取完整的属性列表。

### 示例脚本

您可以从 GitHub 上的官方 `title.sh` 示例下载一个完整且具有布局自适应特性的脚本。此脚本提取活跃的工作空间文件夹基准名称 (basename)，并渲染一个包含实时 Agent 状态和对话会话前缀的结构化终端标题。

将脚本保存到 `~/.gemini/antigravity-cli/title.sh` 并赋予其执行权限：

```bash
chmod +x ~/.gemini/antigravity-cli/title.sh
```

## 参见 (See also)

* **自定义状态栏**：自定义动态 TUI 状态栏。
* **设置、渲染与键绑定**：自定义键盘快捷键和缓冲区。
* **权限与沙箱**：管理安全目录权限。