HN 日本語サマリー

← 一覧へ戻る
プログラミング

Ghostel.el: libghosttyを搭載したターミナルエミュレータ

Ghostel.el: Terminal emulator powered by libghostty (dakra.github.io)

249 pointsby signa1143 コメント

要約

Ghostel.elは、Ghosttyターミナルと同じVTエンジンであるlibghostty-vtを基盤としたEmacs用のターミナルエミュレータです。Zigで書かれたネイティブモジュールがターミナル状態、レンダリング、ローカルPTY I/Oを処理し、Elispがキーマップ、バッファ、コマンド、リモートプロセス統合を管理します。Kittyキーボード/グラフィックスプロトコル、リッチな下線スタイル、OSC 8ハイパーリンク、OSC 4/10/11カラークエリ、同期出力(DEC 2026)などの最新機能をサポートしています。

全文翻訳

ghostel.el - libghosttyで動作するターミナルエミュレータ

目次

[画像: MELPA] [画像: MELPA Stable] [画像: CI] [画像: Release] [画像: License: GPL-3.0-or-later] [画像: VT engine: libghostty-vt]

Ghostelは、Ghosttyターミナルを駆動するVTエンジンと同じlibghostty-vtを搭載したEmacsターミナルエミュレータです。Zigで書かれたネイティブダイナミックモジュールがターミナル状態、レンダリング、ローカルPTY I/Oを処理し、Elispがキーマップ、バッファ、コマンド、リモートプロセス統合を管理します。

Ghostelはemacs-libvtermに触発されており、同じ2層設計を踏襲していますが、libvtermの代わりにGhosttyのモダンなVTエンジンを使用しています。これにより、Kittyキーボードおよびグラフィックスプロトコル、リッチな下線スタイル、OSC 8ハイパーリンク、OSC 4/10/11カラークエリ、同期出力(DEC 2026)が可能になります。これらはlibvtermではサポートされていません。Ghostel vs vterm and eatで詳細な比較を参照してください。

初回使用時に、Ghostelはプリビルドされたネイティブモジュールのダウンロードを提案するため、一般的なケースではツールチェーンは不要です。ターミナルを開くには M-x ghostel を使用します。

目次

[画像: MELPA] [画像: MELPA Stable] [画像: CI] [画像: Release] [画像: License: GPL-3.0-or-later] [画像: VT engine: libghostty-vt]

Ghostelは、Ghosttyターミナルを駆動するVTエンジンと同じlibghostty-vtを搭載したEmacsターミナルエミュレータです。Zigで書かれたネイティブダイナミックモジュールがターミナル状態、レンダリング、ローカルPTY I/Oを処理し、Elispがキーマップ、バッファ、コマンド、リモートプロセス統合を管理します。

Ghostelはemacs-libvtermに触発されており、同じ2層設計を踏襲していますが、libvtermの代わりにGhosttyのモダンなVTエンジンを使用しています。これにより、Kittyキーボードおよびグラフィックスプロトコル、リッチな下線スタイル、OSC 8ハイパーリンク、OSC 4/10/11カラークエリ、同期出力(DEC 2026)が可能になります。これらはlibvtermではサポートされていません。Ghostel vs vterm and eatで詳細な比較を参照してください。

初回使用時に、Ghostelはプリビルドされたネイティブモジュールのダウンロードを提案するため、一般的なケースではツールチェーンは不要です。ターミナルを開くには M-x ghostel を使用します。

1. クイックスタート

(use-package ghostel
  :bind (("C-x m" . ghostel)
         :map ghostel-semi-char-mode-map
         ("C-s"  . consult-line)
         ("C-k"  . my/ghostel-send-C-k-and-kill)
                           ("M-p" . (lambda () (interactive) (ghostel-send-key "p" "ctrl")))
         ("M-n" . (lambda () (interactive) (ghostel-send-key "n" "ctrl"))))
  :config
  (defun my/ghostel-send-C-k-and-kill ()
    "Send `C-k' to ghostel.
Like normal Emacs `C-k'.  Kill to end of line and put content in kill-ring."
    (interactive)
    (kill-ring-save (point) (line-end-position))
    (ghostel-send-key "k" "ctrl"))

  (add-to-list 'ghostel-eval-cmds '("magit-status-setup-buffer" magit-status-setup-buffer)))

(use-package ghostel-project
  :bind (:map project-prefix-map
         ("m" . ghostel-project)
         ("M" . ghostel-project-list-buffers))
  :config
  (add-to-list 'project-switch-commands '(ghostel-project "Ghostel") t)
  (add-to-list 'project-switch-commands '(ghostel-project-list-buffers "Ghostel buffers") t))

(use-package ghostel-eshell
  :hook (eshell-load . ghostel-eshell-visual-command-mode))

(use-package ghostel-compile
  :hook (after-init . ghostel-compile-global-mode))

(use-package ghostel-shell-command
  :hook (after-init . ghostel-shell-command-global-mode))

(use-package ghostel-comint
  :hook (after-init . ghostel-comint-global-mode))

(use-package ghostel-org
  :after org)

Evilユーザーの場合は、evil-ghostel拡張機能をインストールできます。

(use-package evil-ghostel
  :after (ghostel evil)
  :hook (ghostel-mode . evil-ghostel-mode))
1.1. シェル統合の概要

ローカルのbash、zsh、fish、またはnushellセッションでは、ディレクトリ追跡とプロンプトナビゲーションがデフォルトで有効になっています。TRAMPサポートなどの詳細については、シェル統合を参照してください。

シェルからEmacs関数を呼び出すには、それらをghostel-eval-cmdsホワイトリストに追加し、bashrcに以下のようなものを追加する必要があります。

if [[ "$INSIDE_EMACS" = 'ghostel' ]]; then
        e()   { ghostel_cmd find-file-other-window "$@"; }

        dow() { ghostel_cmd dired-other-window "$@"; }

        gst() { ghostel_cmd magit-status-setup-buffer "$(pwd)"; }
fi
1.2. 入力モードの概要

Ghostelは、eat.elスタイルの入力モードを5つ提供しています。

デフォルトはセミキャラクタモードで、M-xやC-cなどのいくつかの例外を除き、ほとんどすべてのキーをターミナルに転送します。

キャラクタモードでは、すべてのキーがターミナルに送信されます。終了するには M-RET を押します。

ラインモードでは、Ghostelは M-x shell のように動作します。バッファは通常のEmacsバッファであり、どのキーもターミナルに送信されません。行の入力を完了して RET を押した後にのみ、行全体が一度にターミナルに送信されます。

Emacsモードとコピーモードは、バッファを一時的に通常のEmacsバッファにし、ナビゲーション、表示、テキストコピーができるようにします。両者の違いは、コピーモードがターミナルをフリーズさせるため、連続出力があっても選択中に何も「スクロールしない」ことです。Emacsモードはライブであり、スクロールや選択中に新しい出力が継続的に入ってきます。

C-x C-q(通常の読み取り専用トグル)は、ghostel-readonly-default-modeで選択された好みの読み取り専用モードに入り、コピーモードまたはEmacsモード内で再度押すと終了します。デフォルトはcopyです。

これらの読み取り専用モードには、デフォルトでghostel-readonly-fast-exitが有効になっています。これにより、ターミナルに送信されると予想されるほとんどのキーで自動的に終了します。これにより、シームレスな移行が可能になります。例えば、何らかの出力が実行中にコピーしたいものが見つかった場合、C-c C-tを押してコピーモードに入り、通常のEmacsバッファのようにナビゲートしてテキストを選択します。テキストをコピーするか、任意の文字を入力すると、自動的に通常のghostelターミナルセッションに戻ります。マウスでの選択、ハイパーリンクへの移動(C-c C-p)、またはマークの有効化などの一部のアクションもコピーモードを自動的にアクティブにします。

2. 要件

  • Emacs 28.1+(ダイナミックモジュールサポート付き)
  • macOS、Linux、FreeBSD、Android/Termux、またはネイティブWindows

初回使用時に、Ghostelはプリビルドされたネイティブモジュールのダウンロードまたはコンパイルを提案します(ネイティブモジュールを参照)。プリビルドバイナリは以下で利用可能です。

  • aarch64-macos (Apple Silicon)
  • x86_64-macos (Intel Mac)
  • x86_64-linux
  • aarch64-linux
  • x86_64-freebsd
  • aarch64-android (Termux)
  • x86_64-windows
  • aarch64-windows

ソースからビルドしたい場合、または異なるプラットフォームが必要な場合は、正確に Zig 0.16.0が必要です。古いまたは新しいZigバージョンではビルドできません。ソースからのビルドを参照してください。

3. インストール

3.1. MELPA
(use-package ghostel
  :ensure t)
3.2. use-package と :vc (Emacs 30+)
(use-package ghostel
  :vc (:url "https://github.com/dakra/ghostel"
       :lisp-dir "lisp"
       :rev :newest))

:lisp-dir "lisp" は Emacs < 31.1 の場合にのみ必要です。

3.3. use-package と :load-path
(use-package ghostel
  :load-path "/path/to/ghostel/lisp")
3.4. 手動
(add-to-list 'load-path "/path/to/ghostel/lisp")
(require 'ghostel)

その後、ターミナルを開くには M-x ghostel を使用します。

3.5. ネイティブモジュール

ネイティブモジュールが見つからない場合、Ghostelはプリビルドバイナリのダウンロードまたはソースからのコンパイルを提案します。これは ghostel-module-auto-install(デフォルトはask)によって制御されます。手動でトリガーすることもできます。

  • M-x ghostel-download-module - サポートされている最小限のプリビルドバイナリをダウンロードします。
  • C-u M-x ghostel-download-module - 特定のリリースタグを選択します(最新の場合は空白のままにします)。
  • M-x ghostel-module-compile - zig build を介してソースからビルドします。

デフォルトでは、モジュールはパッケージディレクトリから読み書きされます。パッケージマネージャーがEmacsでモジュールがロードされている間にツリーを再ビルドまたは再インストールする場合、ghostel-module-directory をパッケージツリー外の安定した場所にポイントしてください(例: ~/.config/emacs/ghostel/)。

3.6. プラットフォーム固有の注意点
3.6.1. Android (Termux)

TermuxのEmacsはダイナミックモジュールサポート付きでビルドされているため、Ghostelはそこで動作します。プリビルドされたaarch64-androidモジュールはAPIレベル24(Android 7.0、Termuxの最小要件)のbionicにリンクされており、glibcのaarch64-linuxモジュールとは交換できません。

ターミナル起動は /bin/sh を介して行われます。通常のTermuxセッション内では、Termuxのexecシムがそれを$PREFIX/bin/shに書き換えます。シムがない場合、Android自身のsh(Android 9+)に解決されるか、失敗します(Android 7および8)。

Kittyグラフィックス共有メモリ伝送媒体は、bionicにPOSIX共有メモリがないため利用できません。ファイルおよび直接伝送は機能します。

オンデバイスでのコンパイルはTermuxのパッケージで可能です: pkg install zig ndk-sysroot、その後 M-x ghostel-module-compile(または zig build)。NDKがインストールされていない場合、build.zigはndk-sysrootパッケージが$PREFIXの下で提供するbionic sysrootを使用し、ghosttyのスカラー(非SIMD)コードパスをビルドします。デスクトップからのクロスコンパイルにはAndroid NDKが必要です。build.zigは ANDROID_NDK_HOME、ANDROID_HOME、ANDROID_SDK_ROOT、またはデフォルトのSDKロケーションを通じてそれを見つけます。

AndroidはCIでビルドされますが、テストスイートは実行されないため、サポートはベストエフォートです。

3.6.2. Windows

Ghostelは、ダイナミックモジュールサポートを備えたネイティブWindows Emacsビルドをサポートしています。プリビルドリリースモジュールは一般的なx86_64およびaarch64ネイティブEmacsアーキテクチャを対象としています。モジュールDLLは、Windows自体のアーキテクチャではなく、Emacsのアーキテクチャと一致する必要があります。特殊なカスタムEmacsビルド(静的CRTビルドを含む)はベストエフォートです。

ローカルターミナルはWindows ConPTYを使用します。Ghostelはまず、ネイティブモジュールの隣にあるMicrosoftの再配布可能コンソールランタイム(conpty.dllおよび対応するOpenConsole.exeヘルパー)からのサポートファイルを探します。それらが存在する場合、これらのファイルは古い組み込みWindowsバージョンよりも新しいConPTY動作を提供し、インタラクティビティとターミナルプロトコルの一貫性の両方を向上させることができます。それらがインストールされていない場合、Ghostelは組み込みWindows ConPTY APIにフォールバックします。

プリビルドGhostelモジュールをダウンロードすると、同じGhostelリリースからの対応するサポートファイルもダウンロードされます。ローカルでモジュールをコンパイルする場合、Ghostelは最新の利用可能なサポートファイルをインストールしようとします。それらをインストールできなかった場合でも、組み込みConPTYフォールバックが引き続き利用可能であるため、致命的ではありません。

TRAMPリモートターミナルはWindowsからPOSIXリモートに限定されます。これらはローカルConPTYではなくTRAMP/sshを使用するため、PTYはリモートホスト上に存在します。WindowsからTRAMPターミナルへの動的なウィンドウリサイズは現在サポートされていません。

4. ソースからのビルド

ビルドが必要なのは、プリビルドバイナリを使用しない場合のみです。Ghostelは生成されたvendor/emacs-module.hをバンドルしているため、通常のビルドではローカルのEmacsヘッダーは必要ありません。

ビルドには正確に Zig 0.16.0が必要です。古いまたは新しいZigバージョンではビルドできません。インストールされているバージョンを zig version で確認してください。

git clone https://github.com/dakra/ghostel.git
cd ghostel

zig build --prefix . -Doptimize=ReleaseFast

ベンダー化されたEmacsヘッダーをオーバーライドするには、EMACS_INCLUDE_DIR を emacs-module.h を含むディレクトリに設定するか、EMACS_BIN_DIR をEmacsの bin/ ディレクトリに設定します。

  • Ghostelは ../include および ../share/emacs/include を探します。

ローカルのghosttyチェックアウトに対してビルドするには、一時的に依存関係をローカルパスにポイントします。

zig fetch --save=ghostty /path/to/ghostty
zig build --prefix . -Doptimize=ReleaseFast

モジュールと ghostel-module.version サイドカーはZigのインストールプレフィックスの下にインストールされます。Ghostelが直接ロードするチェックアウトにビルドする場合は --prefix . を使用するか、ghostel-module-directory に一致する別のプレフィックスを渡します。Windowsでは、ローカルビルドは通常ZigのMinGWターゲット(例: -Dtarget=x86_64-windows-gnu)を使用するため、一般的なネイティブEmacsビルドと一致し、Windows SDKは不要です。

MELPAからインストールした場合、M-x ghostel-module-compile は zig build --prefix <ghostel-module-directory> を使用してネイティブモジュールをソースからビルドします。Zigパッケージマネージャーはghostty依存関係を自動的に取得します。

4.1. 同梱のterminfo

コンパイルされたxterm-ghostty terminfoエントリは etc/terminfo/ にプリビルドで出荷されており、tic がローカルで生成するものと同一です。ビルドステップは不要で、ファイル形式はBSDおよびncursesシステム間でポータブルです。メンテナーはlibghosttyを更新した後、make regen-terminfo を介してそれを再生成します。

5. シェル統合

シェル統合(OSC 7によるディレクトリ追跡、OSC 133によるプロンプトナビゲーション、OSC 2によるタイトル追跡、およびシェルからElispを呼び出すためのghostel_cmd)は、bash、zsh、fish、およびnushellでは自動です。シェル設定ファイルへの変更は必要ありません。

nushellの場合、OSC 7/133/2はnushell自身の$env.config.shell_integration(デフォルトでオン)から取得されるため、ghostelのghostel.nuはghostel_cmdとアウトバウンドssh terminfoラッパーのみを追加します。shell_integration.osc7および.osc133を有効のままにしておかないと、ディレクトリ追跡とプロンプトナビゲーションが機能しなくなります。

これはghostel-shell-integration(デフォルトt)によって制御されます。自動インジェクションを無効にして、代わりにスクリプトを手動でソースするには、これをnilに設定します。

[[ "${INSIDE_EMACS%%,*}" = 'ghostel' ]] && source "$EMACS_GHOSTEL_PATH/etc/shell/ghostel.bash"
[[ "${${INSIDE_EMACS-}%%,*}" = 'ghostel' ]] && source "$EMACS_GHOSTEL_PATH/etc/shell/ghostel.zsh"
# fish - ~/.config/fish/config.fish に追加:
string match -qr '^ghostel(,|$)' -- "$INSIDE_EMACS"; and source "$EMACS_GHOSTEL_PATH/etc/shell/ghostel.fish"
# nushell - config.nu に追加 (ghostelチェックアウトへの絶対パスを使用してください)。
# nushellの`source'はパース時定数パスを必要とするため、$INSIDE_EMACSでゲートすることはできません。
# スクリプトは使用されるまで不活性なので、無条件ソースは安全です:
source /path/to/ghostel/etc/shell/ghostel.nu

macOSの組み込み /bin/bash はバージョン3.2で、AppleはENV変数の自動インジェクションに依存するパッチを適用しました。そのため、それとの自動統合は機能しません。新しいbash(例: Homebrewのもの)をghostel-shell経由で使用するか、上記のように~/.bashrcからghostel.bashを手動でソースしてください。

リモート(TRAMP / アウトバウンドssh)シェル統合には独自のセットアップがあります。TRAMP (リモートターミナル)を参照してください。

6. 入力モード

Ghostelは、eat.elスタイルの入力モードを5つ提供します。新しいターミナルはセミキャラクタモード(ghostel-initial-input-mode)で開始されます。以下のキーバインドでモードを切り替え、現在のモードインジケータをmode-line-processで確認してください。

モードインジケータターミナル入力処理
セミキャラクタ(なし)ライブターミナルに入力、C-cは予約済み
キャラクター:Charライブすべてのキーがターミナルに送信される
Emacs:EmacsライブEmacsナビゲーション/検索/コピー
コピー:CopyフリーズEmacsナビゲーション/検索/コピー、安定した出力
ライン:LineライブEmacsキーで入力を構成し、RETで送信
6.1. モード切り替えキーバインド

キャラクターモードを除くすべてのモードから利用可能です。

キーアクション
C-c C-jセミキャラクタモードに切り替え(ユニバーサル終了)
C-c M-dキャラクターモードに切り替え
C-c C-eEmacsモードのトグル
C-c C-tコピーモードのトグル
C-c C-lラインモードに切り替え
M-RETキャラクターモードのみ:セミキャラクタに戻る
6.2. セミキャラクタモード (デフォルト)

ほとんどのキーはターミナルに送信されます。ghostel-keymap-exceptions(デフォルト: C-c, C-x, C-u, C-h, M-x, M-:, C-\)内のキーはEmacsに渡されます。

キーアクション
ほとんどのキーターミナルに直接送信
C-c C-c割り込み(C-c)を送信
C-c C-z中断(C-z)を送信
C-c C-dEOF(C-d)を送信
C-c C-\終了(C-\)を送信
C-c M-wスクロールバック全体をキルリングにコピー
C-yキルリングからヤンク(ブラケットペースト)
M-yヤンクポップ(キルリングを循環)
C-c C-yキルリングからペースト
C-c M-l画面とスクロールバックをクリア
C-c C-n次のハイパーリンクにジャンプ
C-c C-p前のハイパーリンクにジャンプ
C-c M-n読み取り専用モードに入り、次のプロンプトにジャンプ
C-c M-p読み取り専用モードに入り、前のプロンプトにジャンプ
C-x C-qghostel-readonly-default-modeに入る
C-q (または C-c C-q)次のキーを文字通り送信(エスケープハッチ)
マウスホイールスクロールバックをスクロール
6.3. キャラクターモード

C-c M-dで入ります。すべてのキー(ghostel-keymap-exceptionsを含む)がターミナルに送信されます。C-x、M-x、C-hなどをバインドしたいTUIアプリに便利です。M-RET(またはC-M-m)のみがエスケープハッチです。

6.4. Emacsモード

C-c C-eで入ります。ターミナルは実行を継続し、バッファは読み取り専用になり、標準のEmacsバインドはグローバルマップにフォールスルーします。isearch-forward、occur、M-x、C-SPC + M-w、矢印キー、ホイールスクロール - すべてが変更なしで機能します。ターミナルは出力を生成し続け、バッファは成長し続けます。ポイントがライブターミナルカーソル上にある場合、ウィンドウは新しい出力に従いますが、ポイントを離れた瞬間(または選択を開始した瞬間)、追跡は停止し、ポイントは配置された場所に留まり、ポイントがカーソルに戻ると再開します(M->はライブカーソルにジャンプします)。

ghostel-readonly-fast-exit(デフォルト)が有効な場合、文字を入力するとEmacsモードが終了し、その文字がシェルに送信されます。無効な場合、Emacsモードは「見るだけ、触らない」ビューになります。自己挿入、RET、TAB、DELは読み取り専用バッファにフォールスルーし、text-read-onlyをトリガーするため、誤ったキーストロークがプロンプトに到達することはありません。シェルに入力するには、セミキャラクタモード(C-c C-j)に切り替えます。C-yはどちらの場合もブラケットペーストを介してペーストし、ポイントをライブカーソルに戻します。

C-c C-eはEmacsモードを再度トグルし(読み取り専用に入る前のモードに戻ります)、C-c C-tはコピーモードに切り替えて出力をフリーズします。

ビルドが実行中にスクロールバックを検索したり、M-x occurでストリーミングログをフィルタリングしたり、表示されている履歴全体をマークしてコピーしたり、ターミナルの出力に対してバッファベースのコマンドを実行したりする際に、フリーズせずに使用してください。

6.5. コピーモード

C-c C-tで入ります。ターミナルはフリーズします。ライブ出力は、終了するまでバッファを更新しません。ターミナルがカーソルの下でスクロールするのを防ぎ、正確にテキストを選択したい場合にこれを使用します。積極的なコピーモードキーマップは自己挿入で終了するため、文字を入力するとターミナルに送信され、セミキャラクタモードに戻ります(ghostel-readonly-fast-exitで制御)。

C-c C-tはコピーモードを再度トグルし、C-c C-eはEmacsモードに切り替えます(読み取り専用ですがライブです。出力が再開します)。セミキャラクタを経由しません。

キーアクション
C-SPCマークを設定
M-w / C-w選択範囲をコピーして終了
C-n / C-p行を移動
M-v / C-vページを上/下にスクロール
M-< / M->バッファの先頭/末尾にジャンプ
C-c C-n次のハイパーリンクにジャンプ
C-c C-p前のハイパーリンクにジャンプ
C-c M-n次のプロンプトにジャンプ
C-c M-p前のプロンプトにジャンプ
C-lビューポートを中央揃え
C-x C-q読み取り専用モードを終了
qコピーせずに終了
a - z終了してキーをターミナルに送信

ソフトラップされた改行は、コピーされたテキストから自動的に削除されます。

6.6. マウス選択

Ghostelバッファ内でクリック&ドラッグするとリージョンが作成されます。リリース時に、ghostel-mouse-drag-or-set-regionは入力モードを切り替えるため、ストリーミングターミナル出力が選択範囲を上書きしないようにします。ターゲットはghostel-mouse-drag-input-modeによって選択されます。

  • default(デフォルト)- ghostel-readonly-default-mode(初期値はcopy)で選択されたモードに入ります。
  • copy - コピーモードに入ります。再描画が一時停止し、選択範囲はどこにあっても安定します。
  • emacs - Emacsモードに入ります。ターミナルはストリーミングを継続し、バッファは読み取り専用になります。リージョンがアクティブな間、ウィンドウはライブ出力に追従しません。スクロールバックの行全体にまたがる選択は保持されますが、ライブプログラムが書き換える行にまたがる選択は失われる可能性があります。
  • nil - セミキャラクタモードのままにします。選択範囲の保持保証はemacsと同じですが、M-wはシェルに転送されるためリージョンをコピーできません。プライマリ選択またはGUIメニューでコピーする場合にのみ選択してください。

選択されていないウィンドウにフォーカスするクリックは、そのウィンドウにフォーカスを与えるだけです。ポイントはクリック位置ではなく、ターミナルの入力カーソルに配置され、入力モードは変更されません。したがって、ウィンドウにフォーカスするためのクリックは、バッファをフリーズさせることはありません。(クリック機能が無効になるようにghostel-mouse-drag-input-modeをnilに設定してください。これにより、クリックは他のEmacsバッファのようにポイントを設定します。)Ghostelがターミナル入力モードにあり、TUIがDECマウス追跡(1000/1002/1003 - htop、lazygitなど)を有効にしている場合、クリックはプログラムに転送され、上記のいずれも適用されません。コピー、Emacs、ラインモードは、ターミナルマウス追跡がアクティブな場合でも、通常のEmacsマウス動作を維持します。

ダブルクリックとトリプルクリックは、カーソル下の単語と行をそれぞれ選択し、ドラッグと同様にそのリージョンを保護します(フォーカスされているかどうかにかかわらず、どのウィンドウからでも)。

キーボード選択にも同様の保護があります。コマンドがセミキャラクタモードでマークをアクティブにする場合(C-SPC(set-mark-command)、expand-regionのバリアント、C-x h、リージョンをオンにするあらゆるコマンド)、Ghostelはghostel-mark-activation-input-modeで選択されたモードに切り替えます(defaultはghostel-readonly-default-modeに従います。copy、emacs、またはnilはセミキャラクタのままにします)。これはマークアクティベーションをフックし、特定のキーではなく、カスタムバインド(set-mark-or-expandなど)もトリガーします。TTYではCtrl+SpaceはC-@(NUL)と区別がつかずターミナルに転送されることに注意してください。キャラクタモードでは、Ctrl+Spaceは常にNULとしてターミナルに到達します(GUIとTTYの両方)。

ポイントがライブ入力ポイントから移動するだけで何も選択しない場合も同様です。isearch(isearch-mode-end-hook経由)やconsult-lineのようなミニバッファコマンド(minibuffer-exit-hook経由)は、ghostel-point-leave-input-modeで選択されたモードに切り替えます(defaultはghostel-readonly-default-modeに従います。copy、emacs、またはnilは無効にします)。これにより、位置がフリーズされ、コンテンツがポイントをプロンプトに戻す代わりにナビゲート可能になります。

他のジャンプパッケージには組み込みフックがないため、ghostel-maybe-leave-inputコマンドで接続します。これは、Ghostelがセミキャラクタモードで、ポイントがライブカーソルから移動した場合にのみghostel-point-leave-input-modeを適用する、ノーオペレーションです。引数を無視するため、フック関数と:afterアドバイスの両方として機能します。

(add-hook 'flash-after-jump-hook #'ghostel-maybe-leave-input)

(with-eval-after-load 'avy
  (advice-add 'avy-action-goto :after #'ghostel-maybe-leave-input))
6.7. ラインモード

C-c C-lで入ります。ラインモードはユーザーの入力をEmacs内でローカルにバッファリングします。キーストロークはコンポーズ中にシェルに転送されません。完全なEmacs編集(M-b、M-DEL、C-yヤンク、transpose-wordsなど)が入力領域で機能します。RETを押すと、行全体が一度にシェルに送信されます。bashはそれをアトミックに受信し、エコーして実行します。

ターミナルはライブのままです。出力はストリーミングを継続し、バッファは編集中に再レンダリングを継続します。遅延再描画パスのスナップショット/復元ステップは、各再描画前に進行中の入力をキャプチャし、後で新しいプロンプトの末尾に再挿入します。これにより、非同期出力や新しいプロンプトが編集中に到着しても、入力した内容が上書きされることはありません。RETの後、ラインモードはアクティブなままです。次のプロンプトは次の再描画サイクルで見つかり、入力マーカーがそこに移動します。

ウィンドウはライブエッジに乗っているポイント(コンポーズ中の入力領域、またはコマンド実行中の出力末尾)をライブ出力で追跡します。ポイントをスクロールバックに移動するとビューはそのまま留まります。M->、プロンプトのクリック、または単に入力すると追跡が再開します。

ラインモードはターミナルカーソルを入力領域の境界として使用するため、シェル統合のないREPL(python3、irb、sqlite3など)も機能します。カーソル行にOSC 133プロンプトマーカーが存在する場合、プロンプトプレフィックスが認識され、入力境界がその後ろに着地します。OSC 133がない場合のフォールバックとして、プロンプトプレフィックスはghostel-prompt-regexpと照合されます。

ラインモードとフルスクリーンTUI(vim、less、htopなど)は同じキーストリームを共有できません。TUIはすべてのキーを生のまま転送する必要があり、ラインモードはそれらをローカルにバッファリングします。Ghostelはこれを透過的に処理します。代替スクリーンTUIが開始されると、ラインモードはセミキャラクタにドロップするため、TUIはキーを取得し、終了時に再開する旨の短いメッセージが表示されます。TUIが終了すると、ラインモードは新しいプロンプトで再開します。

アルトスクリーン上でC-c C-lを押すと、実行中のものに対して適切な処理が行われます。生のTUI上では、TUIが終了したときにラインモードがアクティブになるように、同じ自動再開がアームされます。明示的なモードスイッチ(C-c C-j、ghostel-char-modeなど)はアームをキャンセルします。内部シェルプロンプト(GhostelにOSC 133マーカーがパススルー経由で到達するtmux=/=screenセッション)では、C-c C-lはそのプロンプトで直接ラインモードに入ります。それらのマーカーがパススルーしない場合、C-u C-c C-lはそれでも強制的にエントリします。

TABはghostel-line-mode-completion-at-point-functions(デフォルトでcomintファイル名/コマンド補完)を介して入力を補完し、オプションでghostel-line-mode-use-bash-completionを介してbashプログラマブル補完を上にレイヤー化します。

キーアクション
(文字)ローカル入力を編集(文字ごとに送信されない)
RET行全体をシェルに送信し、ラインモードのまま
TABポイントでの入力を補完
C-c C-c入力を破棄してSIGINTを送信し、ラインモードのまま
C-d文字を削除、または空の入力でEOFを送信
M-p / M-nヒストリリング:前のエントリ/次のエントリ
C-aプロンプト行の入力の先頭、それ以外はbeginning-of-line
C-c C-jセミキャラクタモードに終了(入力を破棄)

7. 機能

7.1. ターミナルエミュレーション
  • libghostty-vtによる完全なVTターミナルエミュレーション。
  • 256色およびRGB(24ビットトゥルーカラー)サポート。
  • TERM=xterm-ghosttyと同梱のterminfo - アプリケーションがterminfoを機能のために参照する場合(Claude Code、neovim、tmux、モダンなTUI)、同期出力(DEC 2026)、Kittyキーボードプロトコル、トゥルーカラー、カラー下線、フォーカスレポートなどを検出し、高速パスを使用します。特に同期出力は、Claude Codeが大きなスクロールバックの上に再描画する際の、ギクシャクした部分的な再描画効果を排除します。OSC 52(クリップボード)もサポートされていますが、同梱のterminfoでは意図的に広告されていません(クリップボードを参照)。ghostel-termでオーバーライドしてください。
  • OSC 4 / 10 / 11 カラークエリ - TUIプログラムは現在のパレット、前景、背景色をクエリできるため、duf、btop、deltaなどのツールや、termenvを使用するその他のツールは、Emacsのフェイスカラーから適切なライト/ダークテーマを自動検出します。
  • CSI ? 996 / モード 2031 - カラースキームDSR。CSI ? 996 nは、Emacsがghostel-defaultの背景(color-dark-p)を分類するに応じて、CSI ? 997 ; 1 n(ダーク)または; 2 n(ライト)で応答します。子自身のOSC 11オーバーライドはそれを変更しません。モード2031を有効にしたクライアントは、分類が変更されたときに非要求型997を受け取ります(ghostel-sync-theme、テーマ変更時に自動)。
  • OSC 9 / OSC 777 / OSC 7501 - デスクトップ通知とプログラムステータス(通知と進捗を参照)。
  • テキスト属性:太字、イタリック、薄い、下線(単一/二重/カーリー/点線/破線、色付き)、取り消し線、反転。
  • カーソル形状:ブロック、バー、下線、中空ブロック - それぞれ点滅あり/なし。
  • 代替スクリーンバッファ(htop、vimなどのTUIアプリ用)。
  • スクロールバックバッファ(設定可能、デフォルト5MB / 約5,000行、Emacsバッファにマテリアライズされるため isearch / consult-line が履歴全体で機能します)。
7.2. プロセスモデル

ローカルghostelバッファはデフォルトでネイティブPTYパスを使用します(ghostel-use-native-pty)。ネイティブリーダーはバックグラウンドスレッドでPTY出力を消費し、libghostty-vtを非同期に更新し、コールバックまたは再描画が必要な場合にイベントパイプを介してEmacsに通知します。これにより、大きなログストリームやフルスクリーンTUIの再描画が、バイト単位でEmacsプロセスフィルターを通過するのを防ぎます。

リモートTRAMPバッファは引き続きEmacsプロセス機構を使用するため、TRAMPはリモートホストでシェルを起動し、そのファイルハンドラを適用できます。レンダリングおよび入力APIは両方のパスで共有されます。

7.3. ブックマーク

GhostelバッファはEmacsの組み込みブックマークで機能します。bookmark-set(C-x r m)はターミナルの作業ディレクトリとバッファ名を記録します。bookmark-jump(C-x r b)はそれを再オープンします。名前付きのライブghostelバッファを再利用するか、存在しない場合はブックマークされたディレクトリで新しいシェルを開始します。ブックマークはディレクトリと名前のみをキャプチャし(スクロールバックやセッション内容は含まない)、vtermと一致します。

ghostel-bookmark-check-dir(デフォルトt)はディレクトリ復元を制御します。新しいバッファはそのディレクトリでシェルを開始し、後で移動した再利用バッファはシェルにcdが入力されます。cdはアイドル状態のシェルにのみ入力されます。コマンド実行中(シェル統合を通じて検出)、またはフルスクリーンプログラムが開いている場合、またはプロンプト行にすでに何らかの入力がある場合は入力されません。nilに設定すると、ディレクトリは変更されません。

7.4. デスクトップ

Ghostelはdesktop.elと統合して、再起動時にターミナルバッファを復元します。ブックマークと同様に、保存および復元されるのはディレクトリとIDのみであり、スクロールバックやセッション内容は含まれません。

保存された一部のターミナルは、復元時にスキップされます(*Messages*に報告されます)。プログラムを実行していたターミナル(ghostel-exec、ghostel-compile、eshellビジュアルコマンド)は、保存されたコマンド(例: ビルド)の再実行を避けるために再起動されません。リモート(TRAMP)ターミナルも同様の理由でスキップされます。それらのシェルを起動すると接続が開かれ、資格情報の入力を求める可能性があります。保存されたディレクトリが存在しないターミナルはロードに失敗し、*Messages*にエラーが表示されます。シェルがすでに終了したターミナルは、そもそも保存されません。

復元されたターミナルは実際のシェルを起動するため、再起動時に大量になる可能性があります。desktop-restore-eagerオプションは、desktop-read自体で復元されるバッファの数を制限し、残りはアイドル時間まで延期します。

7.5. Orgリンク

ghostel-orgは、ディレクトリとオプションでバッファ名を指定するghostel: Orgリンクタイプを追加します。

[[ghostel:~/src/project][project shell]]
[[ghostel:~/src/project::*ghostel*][my shell, in project]]

最初の形式をフォローすると、そのディレクトリを作業ディレクトリとするライブghostelターミナルにポップするか、存在しない場合はそこで新しいシェルを開始します。2番目の形式はブックマークのように動作します。指定されたバッファに切り替え、別の場所に配置されている場合はcdを入力し、それ以外の場合はそのバッファをディレクトリで開始します。org-store-linkをghostelバッファで実行すると2番目の形式が保存され、org-insert-linkはディレクトリプロンプトでghostel:を補完します。

以下を追加してください。

(with-eval-after-load 'org (require 'ghostel-org))

または

(use-package ghostel-org
  :after org)

をあなたの設定に追加してください。

7.6. リンクとファイル検出
  • OSC 8ハイパーリンク - ターミナルプログラムによってエミットされるクリック可能なURL(クリックまたはRETで開く)。
  • プレーンテキストURL検出 - OSC 8がなくても http:// および https:// URLを自動的にリンク化します(ghostel-enable-url-detectionでトグル)。
  • ファイルパス検出 - /path/to/file.el:42のようなパターンがクリック可能になり、指定された行のファイルを開きます(ghostel-enable-file-detectionでトグル。パスパターンはghostel-file-detection-path-regexで調整)。
  • ラップされたリンク - ターミナルに長すぎるURLまたはパスは行をまたいで分割され、各行が全体のターゲットに対してクリック可能になります。ハイパーリンクナビゲーションはこのようなリンクを一度訪れ、ウィンドウリサイズでターミナルが再フローしてもそのまま残ります。
  • thing-at-pointとffap - thing-at-point(filename、existing-filename、url)は、ラップされた行全体を返します。これはbrowse-url-at-point、embarkのURLターゲット、およびfind-fileのM-nデフォルトで拾われます。find-file-at-pointはghostel-find-file-at-pointにリマップされ、これは行のブレークで停止するのではなく、指定された行でリンクを開きます。
7.7. クリップボード
  • OSC 52クリップボード - ターミナルプログラムはEmacsキルリングとシステムクリップボードを設定できます(ghostel-enable-osc52でオプトイン、リモートSSHセッションに便利)。同梱のxterm-ghostty terminfoは、Ms機能を意図的に広告しないため、アプリはそれを自動検出しないようにします。これにより、ghostel-enable-osc52がデフォルトのnilの場合のサイレントクリップボードドロップを防ぎます。OSC 52を有効にし、アプリ(neovim、tmux)にそれを自動検出させたい場合は、アップストリームGhosttyのterminfoを同じパスにインストールするか、TERMINFOをオーバーライドしてください。
  • ブラケットペースト - キルリングからのヤンクは、シェルが正しく処理できるようにブラケットペーストとしてテキストを送信します。
7.8. 入力
  • Ghosttyキーエンコーダーによる完全なキーボード入力(ターミナルモード、Kittyキーボードプロトコルを尊重)。
  • SGRマウスプロトコルによるマウス追跡(プレス、リリース、ドラッグ) - TUIアプリは完全なマウス入力を受信します。
  • DECモード1004によるフォーカスイベント。
  • ドラッグ&ドロップ(ファイルパスとテキスト)。
7.9. パスワードプロンプト検出

sudo、ssh、gpg、passwdなどがパスワードを要求する場合、ghostelはread-passwdをポップアップし、回答をPTY経由で送信します。キーストロークはEmacsの通常のキーパイプラインを通過しないため、パスワードはview-lossage、最近のキーリング、またはキーボードマクロ記録に入りません。これはghostel-detect-password-prompts(デフォルトt)によって制御されます。

検出には2つのレイヤーがあります。プライマリ信号はlibghosttyのヒューリスティックをミラーリングします。スレーブttyはキャノニカルモードでエコーオフになっており、小さなtcgetattr Zigバインディングを介して読み取られます。これは!ECHOを切り替えるローカルプログラム(sudo、ssh自身のプロンプト、gpgなど)をキャッチします。カーソル行の正規表現フォールバック(ghostel-password-prompt-regex、デフォルトはcomint-password-prompt-regexp)は、tty信号が見ることができないケースをカバーします。フォアグラウンドシェルがリモートホスト上にある場合(ghostel--remote-shell-p、ghostelがOSC 7を介して同期を維持するTRAMP default-directoryから派生)、またはローカルttyの状態を読み取れなかった場合です。ローカルシェルで正規表現を使用しないことは、vimやlessのようなローカルrawモードTUIからの誤検出を防ぎ、構造的なアンカーは$ echo Password:のようなシェル入力行がトリガーされるのを防ぎます。診断にはghostel-debug-start / ghostel-debug-password-events-showを参照してください。

モードラインには、プロンプトが開いている間 = 🔒Password= と表示されます。間違ったパスワードの再試行は自動的に検出されます(カーソルが新しいプロンプト行に移動します)。ワイヤーコピーのパスワードは、送信直後にclear-stringされるため、ヒープに残存しません。

検出はghostel-password-prompt-functionsを介して拡張可能です。これは(ROW) -> string-or-nilのチェーンであり、順に試行されます。デフォルトはread-passwdで読み取ります。ユーザーは自分のもの(auth-source / KeePass / pass / など)を先頭に追加し、デフォルトはフォールバックとして機能します。defcustomドキュメント文字列には、TRAMP対応のauth-source-pick-first-passwordの例が含まれています。

7.10. シェル統合機能
  • bash、zsh、fish、nushellの自動インジェクション - シェルRC編集は不要です。
  • OSC 7 - ディレクトリ追跡(default-directoryはシェルのcwdに従い、リモートホストに対してTRAMP対応)。
  • OSC 133 - セマンティックプロンプトマーカー。これにより、C-c M-n / C-c M-pでのプロンプト間ナビゲーションが可能になります。
  • OSC 2 - タイトル追跡(タイトルはモードラインに表示されます。ghostel-buffer-identification-formatを参照)。バッファ名をタイトルからリネームするには、ghostel-buffer-name-functionを設定します)。
  • OSC 52;e - シェルスクリプトからホワイトリスト化されたEmacs関数を呼び出す(シェルからElispを呼び出すを参照)。
  • OSC 52 - クリップボードサポート(オプトイン、リモートセッション用)。
  • INSIDE_EMACSおよびEMACS_GHOSTEL_PATH環境変数。
7.11. レンダリング
  • 増分再描画 - 変更されていない行はスキップされます。
  • 適応フレームレートによるタイマーベースのバッチ更新。
  • インタラクティブなタイピングエコーのための即時再描画 - PTY出力がキーストロークの直後に到着した場合、タイマーをバイパスし、キープレスあたりのレイテンシを16〜33ミリ秒削減します。
  • 非同期ローカルPTY出力 - ローカルPTY出力はネイティブリーダーによって解析され、コールバックまたは再描画が必要な場合にのみEmacsに通知されます。
  • セル変更なしでもカーソル位置が更新されます。
  • テーマ対応カラーパレット(ghostel-sync-themeを介してEmacsテーマと同期)。
  • ghostel-window-padding-balanceは、最初の行の前に何も(特に代替スクリーンで)ない場合に、分数行スペースをグリッドの下に配置します。centerはそれをグリッドの上部と下部に分割します(同じ名前のGhosttyオプションと同様)。bottomはそれをグリッドの上にすべて移動させ、最後の行がモードラインにぴったり合うようにします。top(デフォルト)は下部に配置します。
7.12. インライン画像 (Kittyグラフィックスプロトコル)

Ghostelは、libghosttyを介してKittyグラフィックスプロトコルを使用してインライン画像をレンダリングします。実際のツールで使用されている2つの配置モードをサポートしています。

  • 従来の配置 - timg、kitty +kitten icat、および直接Kittyグラフィックスコマンドを発行する任意のツール。
  • Unicodeプレースホルダー配置(U+10EEEE) - yaziやその他のモダンな画像プレビューアが画像をバッファのテキストグリッドにアンカーするために使用します。

ピクセルデータはEmacsの組み込み画像サポートを介してレンダリングされます。PNGペイロードはベンダー化されたstbimageによってデコードされ、生のRGB/RGBA/Gray/GrayAlpha伝送はネイティブモジュールでPPMに変換されます。外部ImageMagick依存関係は不要です。

画像にはグラフィカルフレームが必要です。ターミナルフレーム(emacs -nw、emacsclient -t)で作成されたバッファはプロトコルを広告しないため、それをプローブするアプリは独自のテキストレンダリングにフォールバックします。

XTWINOPSサイズクエリ(CSI 14 / 16 / 18 t)は応答されるため、アプリはグラフィックスサポートを検出し画像寸法を選択できます。それがない場合、timgはTERM_PROGRAM=ghosttyの場合でもハーフブロックレンダリングにフォールバックします。

セルのピクセルサイズは、ghostel-cell-pixel-scale(デフォルトauto、ディスプレイDPIから派生)を介して物理ピクセルとして報告されます。ほとんどのディスプレイでは、これはスタンドアロンGhosttyの出力に近似します。ピクセルパーフェクトな整合性(特にLinux Waylandでの分数スケーリングや非標準DPIの場合)には、明示的な数値を設定してください。

7.12.1. 制限事項
  • アルファはドロップされ、合成されません。 すべてのフォーマット(生のRGBA、GrayAlpha、PNG)は、アルファチャンネルを削除するRGBA→PPM変換を経由します(PNGは送信時にlibghosttyのPNGフックによってRGBAにデコードされ、その後同じパスをたどります)。透明なピクセルは、基になるカラー値が何であれレンダリングされます(ほとんどのデコーダーは黒を出力します)。サムネイルやスクリーンショットには許容できますが、半透明のエッジを持つアイコンには理想的ではありません。
  • 仮想配置はセルグリッドに引き伸ばされます。 画像とアスペクト比が異なるc=/=rグリッドを持つUnicodeプレースホルダー配置は、グリッド全体にスケーリングされます。KittyやGhosttyはレターボックス化します。yaziやtimgはグリッドを画像にサイズ設定するため、差は1セル未満に保たれます。
7.13. シェルからElispを呼び出す

Ghostel内で実行されるシェルスクリプトは、ghostel_cmdヘルパー(シェル統合スクリプトによって提供)を介してホワイトリスト化されたElisp関数を呼び出すことができます。

ghostel_cmd find-file "/path/to/file"
ghostel_cmd message "Hello from the shell"

これは予約されたkindバイト(e]52;e;<payload>e\)を持つOSC 52エスケープシーケンスを使用します。これはghostel固有の拡張です。ghostel-eval-cmdsにリストされている関数のみが許可されます。

デフォルトでホワイトリスト化されたコマンド:find-file、find-file-other-window、dired、dired-other-window、message。

以下を追加して独自のものを追加してください。

(add-to-list 'ghostel-eval-cmds '("magit-status-setup-buffer" magit-status-setup-buffer))

例(.bashrc / .zshrcに追加):

if [[ "${INSIDE_EMACS%%,*}" = 'ghostel' ]]; then
        e()   { ghostel_cmd find-file-other-window "$@"; }

        dow() { ghostel_cmd dired-other-window "${1:-$PWD}"; }

        gst() { ghostel_cmd magit-status-setup-buffer "$(pwd)"; }
fi
7.14. 通知と進捗

Ghostelは、ターミナルプログラムが使用する2つの通知プロトコルを認識します。

  • OSC 9(iTerm2形式):ESC ] 9 ; BODY ST - ボディのみ。
  • OSC 777(rxvt notify):ESC ] 777 ; notify ; TITLE ; BODY ST - タイトル+ボディ。

どちらもghostel-notification-functionsフックを(TITLE BODY)と現在のターミナルバッファで実行します。デフォルトメンバーのghostel-default-notifyは、インストールされている場合はalertパッケージを使用します。プラットフォームごとに適切なバックエンド(macOSではosascript、Linuxではlibnotify、Growl、terminal-notifierなど)を選択し、alert-default-styleで設定可能です。MELPAから M-x package-install RET alert RET でインストールしてください。alertが利用できない場合、messageにフォールバックし、これはエコーエリアにのみ表示されます。

デフォルトメンバーを削除して通知をサイレントにするか、独自のメンバーを追加して別の場所にルーティングします。

(remove-hook 'ghostel-notification-functions #'ghostel-default-notify)
(add-hook 'ghostel-notification-functions
          (lambda (title body)
            (alert body :title (or title "ghostel") :category 'ghostel)))

ターミナルベル(BEL)はghostel-bell-functionsを実行します。デフォルトメンバーのghostel-dingがビープ音を鳴らします。サイレントにするには削除してください。

ターミナルEmacs(emacs -nw、emacsclient -t)では、ghostel-tty-forward-notifyは通知をOSC 9 / OSC 777として外部ターミナルに再エミットするため、ssh経由のリモートEmacsはローカルデスクトップに通知を表示します。GUIフレームはghostel-default-notifyにフォールバックします。
tmuxまたはscreenが間に挟まっている場合はドロップされます。このハンドラはパススルーラッパーをエミットしません。

(setq ghostel-notification-functions '(ghostel-tty-forward-notify))

プログラムは、プログラムステータスプロトコル(OSC 7501)を使用して、何を行っているかをターミナルに伝えることもできます。idle、working(オプションのパーセンテージ付き)、done、ユーザーによるblocked(permission、questionまたはauth用)、またはerror、それぞれにメッセージが付いています。Ghostelはサポートクエリに応答するため、プロトコルをプローブするプログラムはそれを使用します。ConEmuのOSC 9;4進捗レポート(ビルドツール、Claude Code)は、プログラムがOSC 7501を使用するまで、同じモデルにマッピングされます。

各ターミナルは、ghostel-program-statusにレポートIDごとに1つのレコードを保持し、ルートIDの下にプログラム自体を保持します。新しいプロンプトまたはプロセスの終了は、workingおよびblockedレコードをドロップします。doneおよびerrorは、そのターミナルに入力を送信するまで(ghostel-status-acknowledge-on-input)残るため、見ていないバッファでもコマンドの終了方法が表示されます。

変更ごとに、(ID OLD NEW)でghostel-program-status-functionsが実行されます。デフォルトメンバーは以下の通りです。

  • ghostel-status-mode-lineはmode-line-processにステータスを表示します:[42%]、[blocked: permission]、[done]、[error]、メッセージはツールチップとして表示されます。ルートレコードの上のblockedまたはerrorレコードは、複数ある場合はカウントを表示します([blocked: permission ×2]、それぞれ1つのツールチップ行)。working(パーセンテージなし)は、インストールされている場合はspinner.elでアニメーションします(ghostel-spinner-type。nilはプレーンな[...]を表示します)。単語はghostel-status-mode-line-labelsから取得されます。
  • ghostel-status-notifyは、バッファが現在表示されていない場合に、ghostel-status-notify-states(デフォルト:blocked、done、error)のステータスに入ると、ghostel-notification-functionsを介してデスクトップ通知を送信します。タイトルはレコードのタイトル、またはアプリです。ghostel-status-appは、親レコードから継承されたアプリを解決します。

ルートレコードのtitleは、ghostel-titleおよびバッファ名のOSC 2タイトルに取って代わります。

7.15. カラーパレット

16個のANSIカラーは、ansi-color-*から継承するEmacsフェイスとして定義されています。

ghostel-color-black         ghostel-color-bright-black
ghostel-color-red           ghostel-color-bright-red
ghostel-color-green         ghostel-color-bright-green
ghostel-color-yellow        ghostel-color-bright-yellow
ghostel-color-blue          ghostel-color-bright-blue
ghostel-color-magenta       ghostel-color-bright-magenta
ghostel-color-cyan          ghostel-color-bright-cyan
ghostel-color-white         ghostel-color-bright-white

ansi-color-*フェイスをカスタマイズするテーマは自動的に適用されます。M-x customize-faceで個々のフェイスをカスタマイズしてください。

デフォルトのテキストはghostel-defaultフェイスから継承し、これはdefaultから継承します。それをカスタマイズして、Ghostelターミナルに、Emacsの他の部分とは異なるデフォルトカラー、フォント、またはサイズを与えます(例: ライトテーマのEmacs内のダークターミナル)。

(set-face-attribute 'ghostel-default nil
                    :foreground "#cdd6f4"
                    :background "#1e1e2e"
                    :family "Iosevka Term")

太字およびイタリックテキストは、ghostel-boldおよびghostel-italicフェイスから継承し、これらはansi-color-boldおよびansi-color-italicから、さらにEmacsのboldおよびitalicから継承します。

太字テキストの色付けはghostel-bold-color(nil = 通常テキストと同じ色、bright = 明るいANSIバリアントを使用、または固定#RRGGBB文字列)に従い、Ghostty 1.2.0のbold-color設定と一致します。

8. TRAMP (リモートターミナル)

default-directoryがTRAMPパス(例: /ssh:host:/home/user/)の場合、M-x ghostelはTRAMPのプロセス機構を介してリモートホストでシェルを起動します。ghostel-tramp-shells変数は、TRAMPメソッドごとに使用するシェルを制御します。

(setq ghostel-tramp-shells
      '(("ssh" login-shell)                  ("sshx" login-shell)
        ("scp" login-shell)
        ("docker" "/bin/sh")))

各エントリは (METHOD SHELL [FALLBACK [ARG...]]) です。SHELLは"/bin/bash"のようなパス、またはlogin-shellシンボル(リモートユーザーのログインシェルをgetent passwd経由で自動検出)にすることができます。FALLBACKは検出に失敗した場合に使用されます。

FALLBACK以降の要素はシェルの追加引数です。指定がない場合、ghostelはタイプに応じたデフォルトを提供します。認識されたシェル(bash、zsh、fish)はログイン+インタラクティブシェル(-l -i)として開始され、ユーザーのrc/profileファイルをソースするため、インタラクティブなssh hostログインをミラーリングします。認識されないシェル(例: /bin/sh)は引数なしで開始されます。このデフォルトは、リモートシェル統合(下記参照)が有効な場合にも適用されるため、独自の構成はそれに加えてロードされます。

  • ただし、bashは統合が依存する--rcfileを無視するため、そこでのみ-iを使用します。オーバーライドするには、FALLBACKの後に引数を明示的にリストします。
(setq ghostel-tramp-shells
      '(("ssh" login-shell nil "-i")            ("docker" "/bin/sh")))

OSC 7ディレクトリ追跡はTRAMP対応です。シェルがリモートホスト名を報告すると、default-directoryはその対応するTRAMPパスに設定され、利用可能な場合は既存のTRAMPプレフィックス(メソッド、ユーザー、マルチホップ)を再利用します。プレフィックスが存在しない場合、メソッドはtramp-default-methodをデフォルトとします。ghostel専用にオーバーライドするには、ghostel-tramp-default-methodを設定します(例: `