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

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

概述 (Overview)

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

交互式切换 (Interactive Toggling)

语法：

/title [on|off]

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

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

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

配置

将 title 配置块添加到您的 ~/.gemini/antigravity-cli/settings.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 并赋予其执行权限：

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

参见 (See also)

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