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/
claudeVia Marketplace (Recommended)
/plugin marketplace add shyuan/shyuan-marketplace
/plugin install ghostty-config@shyuan-marketplaceDirect Install
/plugin marketplace add shyuan/ghostty-config-plugin
/plugin install ghostty-config@ghostty-config-devWhat 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-limitis 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