К основному содержанию
скилл CX Codex

ghostty-config — скилл для Claude Code: что делает и как установить

Скилл ghostty-config помогает настраивать терминал Ghostty: подсказывает синтаксис config.ghostty, валидирует параметры и учитывает отличия macOS и Linux.

Apache-2.0 ★ 173 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add sammcj/agentic-coding --skill ghostty-config -a claude-code
Открыть на GitHub

Что делает ghostty-config

Скилл содержит справочник по конфигурации эмулятора Ghostty, правила загрузки файлов и синтаксис директивы config-file. Он ориентируется в путях XDG и macOS, где настройки из каталога ~/Library/Application Support/... переопределяют файлы из ~/.config/ghostty. Внутри собраны таблицы встроенных CLI-действий вроде ghostty +validate-config и правила составления горячих клавиш с префиксами global: или unconsumed:.

Инструкции учитывают переключение тёмного и светлого режимов через директиву theme, отключение лигатур и вызовы open -na Ghostty.app на macOS. Если применить опцию не на той операционной системе, Ghostty проигнорирует её молча без вывода ошибки.

Какие задачи решает

  • настроить горячие клавиши и последовательности нажатий в Ghostty
  • подобрать синтаксис для темы оформления с переключением light/dark
  • проверить корректность файла конфигурации через ghostty +validate-config
  • настроить шрифты и отключить лигатуры через font-feature

Примеры запросов агенту

  • Собери конфигурацию Ghostty с темами Catppuccin под светлый и тёмный режимы
  • Настрой шорткат для быстрого вызова терминала в config.ghostty на macOS
  • Как отключить лигатуры шрифта в Ghostty?

Как установить ghostty-config

1Через Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --skill ghostty-config -a claude-code

2Вручную: положить файлы

~/.claude/skills/ghostty-config/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ghostty-config/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о ghostty-config

Как установить ghostty-config в Claude Code?

Выполните команду npx skills add sammcj/agentic-coding --skill ghostty-config -a claude-code. Также файл скилла можно сохранить вручную по пути ~/.claude/skills/ghostty-config/SKILL.md.

Что делает ghostty-config?

Предоставляет агенту правила оформления файлов config.ghostty, синтаксис шорткатов, списки CLI-утилит и специфичные параметры под macOS и Linux.

Почему параметр в config.ghostty может не сработать?

Опции, привязанные к конкретной платформе, на другой ОС игнорируются молча, а глобальным сочетаниям global: в macOS требуется выдать разрешение в системных настройках Accessibility.

Исходный текст

SKILL.md · Apache-2.0
---
name: ghostty-config
description: Use when creating, editing or debugging Ghostty terminal configuration - config.ghostty files, config option names and their valid values, keybinds and key sequences, themes, fonts, shell integration, or `ghostty +` CLI actions. Covers macOS and Linux/GTK differences.
metadata:
  config_schema_last_updated: "2026-05-20" # Update when realigning the skill with the latest config schema JSON
---

# Ghostty Configuration

## Config File Locations

Config is optional; with no file Ghostty runs on its defaults. Since Ghostty 1.2.3 the file is named `config.ghostty`; extensionless `config` still loads for backwards compatibility.

- XDG (all platforms): `$XDG_CONFIG_HOME/ghostty/config.ghostty`, then `$XDG_CONFIG_HOME/ghostty/config`. `XDG_CONFIG_HOME` defaults to `~/.config`.
- macOS also: `~/Library/Application Support/com.mitchellh.ghostty/config.ghostty`, then `.../config`.

Every matching file loads, later files overriding earlier ones. Within a location `config.ghostty` loads before `config`. On macOS the macOS-path files load after the XDG ones, so macOS paths win on conflict.

## Syntax

```
# Comments start with #
background = 282c34
font-family = "JetBrains Mono"
keybind = ctrl+z=close_surface
font-family =                     # Empty value resets to default
```

- Keys are case-sensitive: use lowercase.
- Repeatable keys (`font-family`, `keybind`, `palette`, `env`, `link`) accumulate across lines.
- Every config key doubles as a CLI flag: `ghostty --background=282c34 --font-size=14`.

## Includes

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

`config-file` directives are processed at the end of the containing file, so keys written after one still lose to the included file's values. Put overrides in the included file, or include first and keep the parent free of conflicting keys.

## Applying Changes

- Reload: `ctrl+shift+,` (Linux), `cmd+shift+,` (macOS). Some options need a restart; some apply only to newly created terminals.
- Validate after every edit: `ghostty +validate-config`.

## CLI Actions

`ghostty +<action>`; add `--help` for per-action help.

| Command                                 | Purpose                                       |
|-----------------------------------------|-----------------------------------------------|
| `ghostty +validate-config`              | Check the config for errors                   |
| `ghostty +show-config`                  | Show the effective configuration              |
| `ghostty +show-config --default --docs` | Show defaults with documentation              |
| `ghostty +edit-config`                  | Open the config in the default editor         |
| `ghostty +list-fonts`                   | Available fixed-width fonts                   |
| `ghostty +list-themes`                  | Available colour themes                       |
| `ghostty +list-colors`                  | Available X11 colour names                    |
| `ghostty +list-keybinds`                | Current keybinds (`--default` for defaults)   |
| `ghostty +list-actions`                 | All keybind actions                           |
| `ghostty +show-face`                    | Font face information                         |
| `ghostty +ssh-cache`                    | Manage the SSH terminfo cache                 |
| `ghostty +new-window`                   | Open a new window (Linux only)                |

On macOS the `ghostty` binary is a helper tool: launch the terminal with `open -na Ghostty.app`, passing flags as `open -na Ghostty.app --args --font-size=14`. Use `ghostty -e <command>` to run a command in a new terminal.

## Keybind Syntax

Format: `keybind = [prefix:]trigger=action[:param]`

Modifiers: `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
```

- Physical keys use W3C codes (`KeyA`, `key_a`, `Digit1`, `BracketLeft`) and outrank unicode codepoints. Prefer them for non-US layouts.
- Sequences wait indefinitely for the next key.

| Prefix         | Effect                                                                                |
|----------------|---------------------------------------------------------------------------------------|
| `global:`      | System-wide (macOS: needs Accessibility permission; Linux: needs an XDG Desktop Portal) |
| `all:`         | Applies to all terminal surfaces                                                      |
| `unconsumed:`  | Passes the input through as well                                                      |
| `performable:` | Consumes the input only if the action succeeds                                        |

Prefixes combine: `global:unconsumed:ctrl+a=reload_config`. Sequences work with `unconsumed:`/`performable:` but not with `global:` or `all:`.

Ghostty 1.3+ adds modal key tables and in-terminal search actions - see `references/keybindings.md`.

## Gotchas

- Confirm an option's platform before recommending it: the reference tables carry platform markers, and an option gated to another platform silently does nothing.
- `theme` accepts mode switching: `theme = light:catppuccin-latte,dark:catppuccin-mocha`.
- Disable ligatures with `font-feature = -calt` plus `font-feature = -liga`.
- Prefer a theme name from `ghostty +list-themes` over hand-written colours when the user asks for a known theme.

## References

Load one when the task needs it - each is a lookup catalogue, not background reading:

- Naming or checking an option for fonts, colours and themes, cursor appearance, selection or search-match colours, transparency, background images, shaders, cell metrics, scrollbar, window geometry/padding/decoration/startup state, tabs, splits or the quick terminal -> `references/options-appearance.md`
- Naming or checking an option for shell and command startup, shell integration, clipboard, scrollback, mouse (including cursor click-to-move), modifier remapping via `key-remap`, bell, notifications, links, app lifecycle, or the `macos-*`, `gtk-*`, `adw-*` and `linux-*` prefixed families -> `references/options-behaviour.md`
- Naming a keybind action, its `:param` form, key tables or search actions -> `references/keybindings.md`

Platform-gated options sit with their domain, not in a platform bucket: `font-thicken` (macOS) and `window-vsync` (macOS) are in the appearance file. Only the prefixed families above live in the platform sections.

The current schema (including tip releases) is at https://raw.githubusercontent.com/sammcj/vscode-ghostty-config-syntax/refs/heads/main/schema/ghostty-config-syntax.schema.json - large, so query it programmatically rather than reading it whole.

© sammcj · Apache-2.0 · sammcj/agentic-coding

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →
worktree-ghostty davila7 Хук worktree-ghostty открывает в Ghostty три панели при создании worktree: Claude слева, lazygit и yazi справа. Только macOS. 249установок cmux-ghostty manaflow-ai Скилл cmux-ghostty регламентирует работу с сабмодулем Ghostty и сборку GhosttyKit в репозитории cmux. Пригодится при синхронизации форка и обновлении указателей Git. CX Codex +1 4 900установок ghostty-use daymade Скилл ghostty-use для Claude Code сохраняет локальные сессии Codex и Claude CLI в Ghostty перед перезагрузкой и помогает восстановить выбранные вкладки после неё. CX Codex +1 118установок cmux-customization manaflow-ai Скилл cmux-customization учит ИИ настраивать мультиплексор cmux: править cmux.json, добавлять действия в Command Palette, переопределять раскладки окон и задавать параметры терминала через Ghostty. CX Codex +1 7 000установок homebrew-cask-authoring connorads Скилл homebrew-cask-authoring помогает писать, проверять и обновлять формулы Homebrew Cask для macOS и Linux с учётом критериев приёмки репозитория. CX Codex +1 128установок iterm2 julianobarbosa Настраивает iTerm2 и tmux, управляет панелями и сессиями и разбирает неполадки. Помогает работать с терминалом на macOS. CX Codex +1 115установок

Из того же набора73

Весь набор →
step-back Субагент step-back для проверки, не перегружён ли текущий подход избыточными абстракциями. Анализирует код или дизайн и выносит вердикт: продолжать, упрощать или переделать с нуля. CX Codex ★ 173звёзд репо reframe-voice Скилл reframe-voice для Claude Code задаёт стиль доказательных колонок с переосмыслением привычных идей. Помогает разбирать сложные темы в лонгридах без рекламного пафоса. CX Codex +1 ★ 173звёзд репо excalidraw-diagrams Скилл excalidraw-diagrams создаёт и обновляет схемы Excalidraw через интерактивный просмотр MCP или локальный Python-скрипт. CX Codex +1 ★ 173звёзд репо idrive-backup Помогает проверять и менять настройки iDrive Backup на macOS, включая пути резервного копирования и исключения. При изменениях инструмент автоматически сохраняет копии конфигурации. CX Codex +1 ★ 173звёзд репо release-debrief Скилл release-debrief для Claude Code сравнивает свежий релиз поддерживаемого инструмента с последней сохранённой сводкой. Разбирает изменения в Claude Code, OpenCode, llama-swap и llama.cpp. CX Codex +1 ★ 173звёзд репо pptx-to-md Скилл pptx-to-md для Claude Code превращает PPTX в Markdown: один файл на слайд, с текстом, позициями изображений и описанием диаграмм и скриншотов. CX Codex +1 ★ 173звёзд репо web-artifacts-builder-v2 Скилл web-artifacts-builder-v2 собирает сложные HTML-артефакты на React с несколькими компонентами, состоянием или маршрутизацией. Он пригодится, когда нужен готовый автономный HTML-файл. CX Codex +1 ★ 173звёзд репо glean-cli Скилл glean-cli учит агента работать с CLI glean: искать по корпоративному индексу, спрашивать Glean Assistant, читать документы и карточки людей. CX Codex +1 ★ 173звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой