導入したのでメモ。

設定ファイルの場所

実際に使用している設定ファイル

~/.config/ghostty/config

macOSのデフォルト場所(使用していない)

~/Library/Application Support/com.mitchellh.ghostty/config
  • Cmd+, で開かれるファイル
  • 自動生成されたテンプレート(空)
  • 編集しても反映されない(優先度が低いため)

設定ファイルの読み込み優先順位

Ghosttyは以下の順序で設定を読み込み、後から読み込まれた設定が上書きする:

  1. $XDG_CONFIG_HOME/ghostty/config(環境変数設定時)
  2. ~/.config/ghostty/config ← これを使用中
  3. ~/Library/Application Support/com.mitchellh.ghostty/config(macOS固有)

つまり:

  • ~/.config/ghostty/configが存在する場合、これが優先される
  • macOS固有のパスは無視される

管理方法

現在の構成

~/dotfiles/ghostty/config          # 実体
 (シンボリックリンク)
~/.config/ghostty/config            # Ghosttyが読み込む場所

設定変更の手順

# 1. dotfilesのファイルを編集
nvim ~/dotfiles/ghostty/config
 
# 2. Ghosttyで設定をリロード
# Cmd+Shift+, を押す

Cmd+, の動作

  • ~/Library/Application Support/com.mitchellh.ghostty/config が開かれる
  • このファイルを編集しても反映されない
  • Ghostty側の既知の問題(GitHub Discussion #5516)

なぜこうなっているのか

Ghosttyの設計思想

  1. クロスプラットフォーム対応

    • Linux/macOSで同じパス(~/.config/ghostty/config)を使える
    • dotfilesでの管理が容易
  2. macOSネイティブ対応

    • macOSユーザー向けに~/Library/Application Support/もサポート
    • システム標準の場所を好むユーザーへの配慮
  3. 両方サポートする理由

    • ユーザーの選択肢を増やす
    • 既存のmacOSアプリの慣習に従う

現状の問題点

  • Cmd+, が常に~/Library/Application Support/を開く
  • ~/.config/ghostty/configを使用している場合、混乱を招く
  • 将来のアップデートで改善される可能性あり

デフォルト設定の確認方法

すべての設定オプションとデフォルト値を表示

/Applications/Ghostty.app/Contents/MacOS/ghostty +show-config --default --docs | less

現在読み込まれている設定を表示

/Applications/Ghostty.app/Contents/MacOS/ghostty +show-config

利用可能なテーマ一覧

/Applications/Ghostty.app/Contents/MacOS/ghostty +list-themes

利用可能なフォント一覧

/Applications/Ghostty.app/Contents/MacOS/ghostty +list-fonts

トラブルシューティング

設定が反映されない場合

  1. 編集しているファイルを確認
   ls -la ~/.config/ghostty/config
  1. シンボリックリンクが正しいか確認
   readlink ~/.config/ghostty
   # → /Users/ginga/dotfiles/ghostty と表示されるべき
  1. 設定ファイルの構文エラーを確認
    • Ghostty起動時にエラーダイアログが表示される
    • 該当行を修正して Cmd+Shift+, でリロード

macOS固有パスのファイルを削除したい場合

rm ~/Library/Application\ Support/com.mitchellh.ghostty/config
  • 削除しても問題なし(使用していないため)
  • ~/.config/ghostty/configから正常に読み込まれる

参考リンク