mcpField
G
ghostty

ghostty

github.com/oakoss開発2088 回インストール10 週間前に更新
リポジトリ

ghostty について

ghostty は、Ghostty ターミナルエミュレーターの設定やトラブルシューティングを支援するスキルガイドです。CLI 操作、テーマやフォントの確認、設定検証、プラットフォームごとの制約を扱います。

主な機能

  1. 01CLI 操作・テーマ・フォントの確認
  2. 02設定項目とキー割り当ての参照
  3. 03設定ファイルの検証と編集
  4. 04IPC による新規ウィンドウの起動
  5. 05描画やクラッシュレポートの調査

活用シーン

  1. 01利用可能なテーマやフォントの確認
  2. 02設定ファイルのエラー検査
  3. 03スクリプトから新規ウィンドウを起動
  4. 04キー割り当ての調整と表示問題の調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/oakoss/agent-skills --skill ghostty

インストール後、Claude Code で/ghosttyを入力して読み込まれたか確認します。

同梱ファイルreferences/cli-actions.mdreferences/configuration.md

詳細

Ghostty スキル

概要

Ghostty は、プラットフォームネイティブの UI と GPU アクセラレーションを使用する、高速で機能豊富なクロスプラットフォームのターミナルエミュレーターです。設定の照会、テーマやフォントの一覧表示、設定の検証、IPC 経由での新しいウィンドウの起動に使用できる +action コマンド付きの CLI を備えています。ウィンドウ、タブ、分割の管理は CLI コマンドではなく、設定ファイルで構成するキー割り当てアクションを通じて行います。

使用する場面： Ghostty のテーマ、フォント、キー割り当ての設定、設定ファイルの検証、利用可能なアクションやテーマの照会、スクリプトからの新しいウィンドウの起動、ターミナルの描画に関する問題のデバッグ。

使用しない場面： 他のターミナルエミュレーターの管理、ターミナル設定に関係のないタスク。

クイックリファレンス

タスクコマンド／設定ポイント
CLI アクションの一覧表示ghostty +list-actionsCLI アクションではなく、キー割り当てアクションを表示します
テーマの一覧表示ghostty +list-themesインタラクティブな TUI プレビュー。絞り込むには --color=dark を指定
フォントの一覧表示ghostty +list-fontsGhostty のフォント検出機能を使用します
キー割り当ての一覧表示ghostty +list-keybindsデフォルトのみを表示するには --default を追加します
色の一覧表示ghostty +list-colors設定で使用できる名前付き RGB 色
設定の表示ghostty +show-configすべてのオプションを表示するには --default --docs を追加します
設定の検証ghostty +validate-config設定ファイルのエラーを確認します
設定の編集ghostty +edit-config$VISUAL または $EDITOR で設定を開きます
新しいウィンドウ（IPC）ghostty +new-windowD-Bus 経由の Linux／GTK のみ。コマンドには -e を使用します
コマンドの実行ghostty -e htop-e の後の引数がコマンドです
作業ディレクトリの設定ghostty --working-directory=/pathコマンドを実行する前にディレクトリを変更します
カスタム設定ghostty --config-file=/path追加の設定ファイルを読み込みます
バージョンの確認ghostty --versionバージョン情報を表示します
SSH terminfoghostty +ssh-cacheリモートホスト用の SSH terminfo キャッシュを管理します
フォントフェイスの表示ghostty +show-face <codepoint>特定の Unicode コードポイントを描画するフォントを表示します
クラッシュレポートghostty +crash-reportクラッシュレポートを確認、管理します

よくある間違い

間違い正しい方法
ghostty +new-tab や +new-split を CLI コマンドとして実行するこれらはキー割り当てアクションであり、CLI アクションではありません。設定ファイルで keybind = ... を使って設定します
macOS でシンボリックリンクを作成していないのに、フルパスなしで ghostty を実行する/Applications/Ghostty.app/Contents/MacOS/ghostty を使うか、シンボリックリンクを作成します
macOS で +new-window が動作することを期待して使う+new-window は D-Bus IPC を使うため、Linux/GTK でのみ動作します
設定を再読み込みせずに編集するreload_config キー割り当てアクションを使います（デフォルト：Linux では ctrl+shift+comma）
相対パスで --config-file を使うパス解決の問題を避けるため、--config-file には絶対パスを使います
利用可能な一覧を確認せずに不明なアクションを渡すghostty +help を実行して CLI アクションを確認するか、キー割り当てアクションには +list-actions を実行します
CLI アクションとキー割り当てアクションを混同するCLI アクションには +action 構文を使います。キー割り当てアクションは設定ファイルで keybind = key=action を使って設定します

委任

  • 利用可能なアクションとテーマを確認する：Explore エージェントを使って ghostty +list-actions と ghostty +list-themes を実行します
  • ターミナルレイアウトを自動化する：Task エージェントを使って、ウィンドウの作成と設定の変更をスクリプト化します
  • 設定変更を計画する：Plan エージェントを使って、適用前にキー割り当てとテーマの設定を設計します

参考資料

コメント

Markdown 対応