agentmods.dev

ghostty-config

ghostty-config is a skill for Claude Code from shyuan/ghostty-config-plugin. It costs 38 tokens per session (1,099 once invoked), scanned A, original, MIT.

A guide for configuring and troubleshooting Ghostty, a terminal application, including its settings for fonts, colours, keybindings, and scrollback.

In plain words
What is it for?
It helps inspect and change Ghostty configuration on macOS and Linux, and explore themes, appearance, keyboard shortcuts, and other settings.
Why use it?
It reduces mistakes caused by guessing what a Ghostty setting means, accepts, or changes. It requires checking the option's documentation before giving advice.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the ghostty-config plugin — 1 skill shipped together

not rated 5repo 4mo ago A scan 38 tokens original MIT

Good fit It helps inspect and change Ghostty configuration on macOS and Linux, and explore themes, appearance, keyboard shortcuts, and other settings.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/shyuan/ghostty-config-plugin/ghostty-config
View source ↗ shyuan/ghostty-config-plugin
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add shyuan/ghostty-config-plugin --skill ghostty-config
Clone the repo
git clone --depth 1 https://github.com/shyuan/ghostty-config-plugin

Made for: Claude Code.

Or install ghostty-config, the plugin that ships this one along with the rest of its 1 skill.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ghostty-config

README.md
[![agentmods](https://agentmods.dev/badge/skills/shyuan/ghostty-config-plugin/ghostty-config.svg)](https://agentmods.dev/skills/shyuan/ghostty-config-plugin/ghostty-config)
Your own site
<a href="https://agentmods.dev/skills/shyuan/ghostty-config-plugin/ghostty-config"><img src="https://agentmods.dev/badge/skills/shyuan/ghostty-config-plugin/ghostty-config.svg" alt="Measured on agentmods" height="20"></a>
Per session 38 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,099 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00038 $0.01099
Opus 5 $0.00019 $0.00549
Sonnet 5 $0.00008 $0.00220
Haiku 4.5 $0.00004 $0.00110

Measured 8d ago against content hash 784f8bb6444e, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

ghostty-config scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/ghostty-config/SKILL.md · 91 lines

How it starts

The opening of the file, as written. The whole thing — 91 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Ghostty Config Management

The Iron Law

ALWAYS CHECK DOCS VIA MCP TOOL BEFORE GIVING CONFIG ADVICE.
NEVER ASSUME A VALUE'S TYPE, UNIT, OR BEHAVIOR FROM ITS NAME.

Config File Location

  • macOS: ~/Library/Application Support/com.mitchellh.ghostty/config
    • This path takes priority over XDG. Both can coexist, macOS path wins.
  • Linux: ${XDG_CONFIG_HOME:-~/.config}/ghostty/config

The config is a plain text file named config (no extension) inside the directory.

Config Syntax

  • key = value — spaces around = optional
  • # comments only at line start — font-size = 14 # comment is WRONG, # comment becomes part of the value
  • Empty value resets to default: font-size =
  • Multi-value: repeat the key (e.g. font-family for fallback chain)
  • Clear then set: font-family = "" then font-family = NewFont
  • keybind = (empty) removes ALL keybinds including defaults — this does NOT reset to defaults
  • Use ctrl+slash not ctrl+/ in keybinds — / is parsed as key table separator

Core Workflow: Changing Any Config Option

  1. ghostty_get_config_option → read full docs for the option
  2. Check the value type and unit — e.g. scrollback-limit is bytes, not lines
  3. Edit the config file
  4. ghostty_validate_config → verify syntax
  5. Most settings hot-reload; theme changes with light:X,dark:Y syntax may need full restart on macOS

Workflows

Theme

  1. ghostty_list_themes — filter with color="dark" or "light"
  2. Set theme = <name> — manual color settings (background, foreground) override theme colors
  3. Dual theme: theme = light:catppuccin-latte,dark:catppuccin-mocha
  4. After changing themes, if tab bar looks wrong → restart Ghostty (known macOS reload bug)

Font

  1. ghostty_list_fonts → name must match exactly (case-sensitive)
  2. For fallback: repeat font-family on multiple lines
  3. ghostty_show_face → verify which font renders specific characters
  4. macOS CJK users: explicitly set a CJK font (e.g. PingFang SC) to avoid oversized fallback

Read the full file on GitHub · 91 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 91 lines · 38 tokens per session scan A 784f8bb6444e

Subscribe to this mod's changes

ghostty-config is a skill published in the GitHub repository shyuan/ghostty-config-plugin (5 stars, last pushed 4mo ago), licensed MIT. It adds 38 tokens to every session and 1,099 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Claude Codeai-toolsanthropicclaude-code-plugincliconfiguration-management
Related

Other skills, from other repositories

brain-log

Show brain sync and evolution history.

toroleapinc/claude-brain · 10 tokens

alive:demo

Generate a believable, lived-in ALIVE world from a free-text persona description (custom path) or a deterministic sandbox preset. Routes the create/list/activate/deactivate/delete/status surface and orchestrates the 5-stage subagent generation pipeline.

alivecontext/alive · 52 tokens

alive:system-upgrade

Upgrade ALIVE to the current version. Handles v1/v2/v3.x source states, multi-surface aware (alive-mcp / Hermes / Codex), retroactive version detection, partial-failure resume, dry-run previews, and rollback inspection.

alivecontext/alive · 57 tokens

alive:system-cleanup

The world feels messy. Stale tasks, orphan folders, v2 remnants, unsaved sessions — entropy is accumulating and needs to be addressed before it compounds. Scans across all walnuts, then surfaces issues one at a time.

alivecontext/alive · 52 tokens

alive:create-walnut

Something new is emerging. A venture, an experiment, a person entering the orbit, a life area getting serious. It needs its own walnut — its own identity, history, and future. Scaffolds the full structure, maps existing context sources, and optionally migrates files across.

alivecontext/alive · 63 tokens

alive:session-history

Revive sessions (quick or heavy), browse, and search — 'what happened recently?', 'find the session where we discussed X', 'revive yesterday's session'. For single-session recall and multi-session browsing. If the human needs to merge multiple sessions into one working context or detect conflicts between parallel…

alivecontext/alive · 76 tokens