mcpField
G
ghostty-config

ghostty-config

github.com/sammcj开发167222 次安装1 天前更新
代码仓库

关于 ghostty-config

为 Ghostty 用户提供配置与命令行操作指导的技能，适合需要调整终端设置或排查配置问题的人。内容涵盖配置文件位置、语法、键绑定、应用变更和 CLI 操作，并提醒核对平台限制。

主要功能

  1. 01说明配置文件位置与加载顺序
  2. 02介绍配置语法和文件包含
  3. 03讲解键绑定格式与前缀
  4. 04提供重载及配置验证方法
  5. 05汇总 Ghostty CLI 操作

适用场景

  1. 01定位并编辑 Ghostty 配置文件
  2. 02设置快捷键或引入其他配置文件
  3. 03验证配置并查看生效设置
  4. 04查找字体、主题或键绑定相关操作

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/sammcj/agentic-coding --skill ghostty-config

安装后在 Claude Code 中输入/ghostty-config确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

CLAUDE.md
references/
keybindings.md
options-appearance.md
options-behaviour.md

详细介绍

Ghostty 配置

配置文件位置

配置文件为可选项；如果没有配置文件，Ghostty 将使用默认设置。自 Ghostty 1.2.3 起，配置文件名为 config.ghostty；为向后兼容，仍会加载不带扩展名的 config。

  • XDG（所有平台）：$XDG_CONFIG_HOME/ghostty/config.ghostty，然后是 $XDG_CONFIG_HOME/ghostty/config。XDG_CONFIG_HOME 默认为 ~/.config。
  • macOS 还会读取：~/Library/Application Support/com.mitchellh.ghostty/config.ghostty，然后是 .../config。

所有匹配的文件都会加载，后加载的文件会覆盖先加载的文件。同一位置下，config.ghostty 先于 config 加载。在 macOS 上，macOS 路径下的文件会在 XDG 文件之后加载，因此发生冲突时以 macOS 路径下的设置为准。

语法

# Comments start with #
background = 282c34
font-family = "JetBrains Mono"
keybind = ctrl+z=close_surface
font-family =                     # Empty value resets to default
  • 键名区分大小写：请使用小写。
  • 可重复的键（font-family、keybind、palette、env、link）会累积多行设置。
  • 每个配置键都可用作 CLI 标志：ghostty --background=282c34 --font-size=14。

包含文件

config-file = themes/dark.conf
config-file = ?local.conf       # ? prefix = optional, no error if missing

config-file 指令会在所属文件处理完毕后执行，因此写在它后面的键仍会被所包含文件中的值覆盖。请将覆盖项放在所包含的文件中，或先包含文件，并确保父文件中没有冲突的键。

应用更改

  • 重新加载：ctrl+shift+,（Linux）、cmd+shift+,（macOS）。某些选项需要重启；某些选项仅对新建的终端生效。
  • 每次编辑后都进行验证：ghostty +validate-config。

CLI 操作

ghostty +<action>；添加 --help 可查看各项操作的帮助。

命令用途
ghostty +validate-config检查配置中是否存在错误
ghostty +show-config显示生效的配置
ghostty +show-config --default --docs显示默认设置及文档
ghostty +edit-config在默认编辑器中打开配置
ghostty +list-fonts可用的等宽字体
ghostty +list-themes可用的配色主题
ghostty +list-colors可用的 X11 颜色名称
ghostty +list-keybinds当前快捷键（使用 --default 查看默认值）
ghostty +list-actions所有快捷键操作
ghostty +show-face字体字面信息
ghostty +ssh-cache管理 SSH terminfo 缓存
ghostty +new-window打开新窗口（仅限 Linux）

在 macOS 上，ghostty 二进制文件是一个辅助工具：使用 open -na Ghostty.app 启动终端，并通过 open -na Ghostty.app --args --font-size=14 传递标志。使用 ghostty -e <command> 可在新终端中运行命令。

按键绑定语法

格式：keybind = [prefix:]trigger=action[:param]

修饰键：shift、ctrl/control、alt/opt/option、super/cmd/command。

keybind = ctrl+shift+t=new_tab
keybind = super+backquote=toggle_quick_terminal
keybind = ctrl+a>n=new_window          # Sequence: press ctrl+a, release, press n
keybind = clear                        # Remove ALL keybinds, including defaults
keybind = ctrl+a=unbind                # Remove one binding
keybind = ctrl+a=ignore                # Ghostty and the terminal both ignore the key
  • 物理按键使用 W3C 代码（KeyA、key_a、Digit1、BracketLeft），优先级高于 Unicode 码点。对于非美式键盘布局，建议使用物理按键。
  • 序列会无限期等待下一个按键。
前缀效果
global:系统级（macOS：需要“辅助功能”权限；Linux：需要 XDG Desktop Portal）
all:应用于所有终端界面
unconsumed:同时将输入传递下去
performable:仅在操作成功时才拦截输入

前缀可以组合：global:unconsumed:ctrl+a=reload_config。序列可与 unconsumed:/performable: 配合使用，但不能与 global: 或 all: 配合使用。

Ghostty 1.3+ 新增了模态按键表和终端内搜索操作，详见 references/keybindings.md。

注意事项

  • 推荐选项前，请先确认其适用的平台：参考表格中标注了平台，而仅适用于其他平台的选项会静默失效。
  • theme 支持按模式切换：theme = light:catppuccin-latte,dark:catppuccin-mocha。
  • 使用 font-feature = -calt 和 font-feature = -liga 禁用连字。
  • 用户询问已知主题时，优先从 ghostty +list-themes 中选择主题名称，而不是手动编写颜色。

参考资料

仅在任务需要时加载；每份资料都是查询目录，而非背景阅读材料：

  • 查询或核实字体、颜色和主题、光标外观、选区或搜索匹配颜色、透明度、背景图片、着色器、单元格度量、滚动条、窗口几何尺寸/内边距/装饰/启动状态、标签页、分屏或快速终端相关选项的名称 → references/options-appearance.md
  • 查询或核实 shell 和命令启动、shell 集成、剪贴板、回滚缓冲区、鼠标（包括单击光标移动）、通过 key-remap 重新映射修饰键、提示音、通知、链接、应用生命周期，或 macos-*、gtk-*、adw-* 和 linux-* 前缀系列相关选项的名称 → references/options-behaviour.md
  • 查询按键绑定操作、其 :param 格式、按键表或搜索操作的名称 → references/keybindings.md

受平台限制的选项归在其所属领域，而非平台分类中：font-thicken（macOS）和 window-vsync（macOS）位于外观文件中。只有上述带前缀的系列才位于平台章节中。

当前架构（包括提示版本）位于 https://raw.githubusercontent.com/sammcj/vscode-ghostty-config-syntax/refs/heads/main/schema/ghostty-config-syntax.schema.json — 文件较大，建议以编程方式查询，而不是完整读取。

评论

支持 Markdown