ghostty

Ghostty 技能

概述

Ghostty 是一款快速、功能丰富、跨平台的终端模拟器，采用平台原生 UI 和 GPU 加速。它提供带有 +action 命令的 CLI，可用于查询配置、列出主题／字体、验证配置，以及通过 IPC 打开新窗口。窗口、标签页和分屏的管理通过配置文件中设置的按键绑定操作完成，而非通过 CLI 命令。

适用场景： 配置 Ghostty 主题、字体和按键绑定；验证配置文件；查询可用操作和主题；从脚本打开新窗口；排查终端渲染问题。

不适用场景： 管理其他终端模拟器；与终端配置无关的任务。

快速参考

任务	命令／配置	要点
列出 CLI 操作	ghostty +list-actions	显示按键绑定操作，而非 CLI 操作
列出主题	ghostty +list-themes	交互式 TUI 预览；使用 --color=dark 筛选
列出字体	ghostty +list-fonts	使用 Ghostty 的字体发现功能
列出按键绑定	ghostty +list-keybinds	添加 --default 仅显示默认项
列出颜色	ghostty +list-colors	配置中可用的命名 RGB 颜色
显示配置	ghostty +show-config	添加 --default --docs 显示所有选项
验证配置	ghostty +validate-config	检查配置文件中的错误
编辑配置	ghostty +edit-config	在 $VISUAL 或 $EDITOR 中打开配置
新建窗口（IPC）	ghostty +new-window	仅限 Linux/GTK，通过 D-Bus；使用 -e 指定命令
运行命令	ghostty -e htop	-e 后的参数是要运行的命令
设置工作目录	ghostty --working-directory=/path	运行命令前切换目录
自定义配置	ghostty --config-file=/path	加载其他配置文件
检查版本	ghostty --version	显示版本信息
SSH terminfo	ghostty +ssh-cache	管理远程主机的 SSH terminfo 缓存
显示字体字形	ghostty +show-face <codepoint>	查看哪个字体渲染特定 Unicode 码位
崩溃报告	ghostty +crash-report	检查和管理崩溃报告

常见错误

错误	正确做法
将 ghostty +new-tab 或 +new-split 用作 CLI 命令	这些是快捷键绑定操作，不是 CLI 操作；在配置文件中使用 keybind = ... 进行配置
在 macOS 上未创建符号链接时，不使用完整路径运行 ghostty	使用 /Applications/Ghostty.app/Contents/MacOS/ghostty，或创建符号链接
在 macOS 上使用 +new-window 并期望它能正常工作	+new-window 使用 D-Bus IPC，仅适用于 Linux/GTK
编辑配置后不重新加载	使用 reload_config 快捷键绑定操作（默认：Linux 上为 ctrl+shift+comma）
使用相对路径搭配 --config-file	为 --config-file 使用绝对路径，避免路径解析问题
未检查可用列表便传入未知操作	运行 ghostty +help 查看 CLI 操作，或运行 +list-actions 查看快捷键绑定操作
混淆 CLI 操作与快捷键绑定操作	CLI 操作使用 +action 语法；快捷键绑定操作通过配置文件中的 keybind = key=action 进行配置

委派

• 发现可用操作和主题：使用 Explore agent 运行 ghostty +list-actions 和 ghostty +list-themes
• 自动化终端布局：使用 Task agent 编写脚本，创建窗口并更改配置
• 规划配置更改：应用更改前，使用 Plan agent 设计快捷键绑定和主题配置

参考资料

• CLI 操作、标志和 IPC 命令
• 配置文件、主题、字体、快捷键绑定和调试