Ghostty Config Plugin for Claude Code

AI-powered Ghostty terminal configuration management — 11 MCP tools + domain knowledge skill.

Installation

Launch Claude Code from your Ghostty config directory and choose local scope when prompted during installation.

# macOS
cd ~/Library/Application\ Support/com.mitchellh.ghostty/

# Linux
cd ${XDG_CONFIG_HOME:-~/.config}/ghostty/

claude

Via Marketplace (Recommended)

/plugin marketplace add shyuan/shyuan-marketplace
/plugin install ghostty-config@shyuan-marketplace

Direct Install

/plugin marketplace add shyuan/ghostty-config-plugin
/plugin install ghostty-config@ghostty-config-dev

What You Get

MCP Tools (11 tools)

Tool	Description
ghostty_search_config_docs	Search config documentation by keyword
ghostty_get_config_option	Get full docs for a specific config option
ghostty_show_current_config	Show active configuration
ghostty_validate_config	Validate config file for errors
ghostty_list_fonts	List available font families
ghostty_list_themes	List available themes (dark/light filter)
ghostty_list_actions	List bindable actions
ghostty_list_keybinds	List current keybindings
ghostty_list_colors	List named colors
ghostty_show_face	Check which font renders specific characters
ghostty_version	Show Ghostty version info

Skill: ghostty-config

Domain knowledge for accurate Ghostty configuration advice:

• Config syntax rules and gotchas
• Standard workflows (change options, switch themes/fonts, set keybindings)
• Common pitfalls (e.g. scrollback-limit is in bytes, not lines)

Quick Start Prompts

After installation, try these in Claude Code:

• "What is scrollback-limit?"
• "List dark themes"
• "What Nerd Fonts are available?"
• "Show my current config changes"
• "Validate my config"
• "What keybinding opens the config file?"
• "Pick me a fun theme and font combo"

Requirements

• Ghostty installed and available in PATH
• Node.js 18+

Standalone MCP Server

If you only need the MCP tools without the Claude Code plugin:

See ghostty-config-mcp for details.

License

MIT

---

Ghostty Config Plugin for Claude Code（中文說明）

AI 驅動的 Ghostty 終端模擬器設定管理 — 11 個 MCP 工具 + 領域知識 Skill。

安裝方式

在 Ghostty 設定檔所在目錄啟動 Claude Code，安裝時選擇 local scope。

# macOS
cd ~/Library/Application\ Support/com.mitchellh.ghostty/

# Linux
cd ${XDG_CONFIG_HOME:-~/.config}/ghostty/

claude

透過 Marketplace 安裝（推薦）

/plugin marketplace add shyuan/shyuan-marketplace
/plugin install ghostty-config@shyuan-marketplace

直接安裝

/plugin marketplace add shyuan/ghostty-config-plugin
/plugin install ghostty-config@ghostty-config-dev

安裝後你會得到

MCP 工具（11 個）

工具	說明
ghostty_search_config_docs	用關鍵字搜尋設定文件
ghostty_get_config_option	取得特定設定項的完整文件
ghostty_show_current_config	顯示目前生效的設定
ghostty_validate_config	驗證設定檔語法
ghostty_list_fonts	列出可用字型家族
ghostty_list_themes	列出可用主題（可篩選深色/淺色）
ghostty_list_actions	列出可綁定的動作
ghostty_list_keybinds	列出目前快捷鍵綁定
ghostty_list_colors	列出具名顏色
ghostty_show_face	查詢特定字元使用的渲染字型
ghostty_version	顯示 Ghostty 版本資訊

Skill：ghostty-config

提供 Ghostty 設定的領域知識，讓 AI 給出正確建議：

• 設定檔語法規則與常見陷阱
• 標準操作流程（修改選項、切換主題/字型、設定快捷鍵）
• 常見錯誤（例如 scrollback-limit 的單位是 bytes 不是行數）

快速入門提示詞

安裝完成後，在 Claude Code 中試試這些：

• 「scrollback-limit 是什麼」
• 「列出暗色主題」
• 「有哪些 Nerd Font 可以用」
• 「顯示我目前改了哪些設定」
• 「驗證我的設定檔」
• 「哪個快捷鍵可以打開設定檔」
• 「隨便幫我找一組有趣的主題和字型組合」

環境需求

• Ghostty 已安裝且在 PATH 中
• Node.js 18+

獨立 MCP Server

如果你只需要 MCP 工具，不需要 Claude Code plugin：

請參考 ghostty-config-mcp。

授權條款

MIT