Ghostel: Emacs テルミナルエミュレータ

Ghostel は、Emacs テルミナルエミュレーションのための高性能なツールです。このプロジェクトは

libghostty-vt

• 256 色および RGB 真色サポート
• Kitty キーボードおよびグラフィクスプロトコル
• リッチアンダーラインスタイル、OSC 8 ハイパーリンク
• OSC 4/10/11 カラークエリ、同期された出力（DEC 2026）

従来の

emacs-libvterm

1. クイックスタート

1.1 シェル統合の概要

• ローカルの bash, zsh, fish セッションに対してデフォルトで ディレクトリ追跡とプロンプトナビゲーションがオンです。
• 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 つのインプットモードを提供します。デフォルトは

semi-char モード

• Semi-char モード（デフォルト）: 例外キーを除き、入力を端末に転送します。
• Char モード: すべてのキーが端末に渡されます。(

  M-RET

  ) で退出します。
• Line モード:

  M-x shell

  のように動作し、入力行全体を一度に送信します。
• Emacs モード: 読み取り専用の Emacs バッファとして動作（ナビゲーション・閲覧用）。
• Copy モード: 端末を凍結させ、安定した選択とコピーが可能です。

読み取り専用モードの特徴:

• 入力キーを押すと自動的に通常のセッションへ戻ります（

  ghostel-readonly-fast-exit

  が有効）。
• マウス選択やハイパーリンク移動時にも自動で active なります。

2. 要件

• Emacs 28.1+ （動的モジュールサポート必須）
• プラットフォーム: macOS, Linux, FreeBSD, Windows

ネイティブモジュール:

• 初回使用時に自動的にダウンロードされます（ツールチェーン不要）。
• 提供されるアーキテクチャ:

  • aarch64-macos

    ,

    x86_64-macos

    (Intel)

  • x86_64-linux

    ,

    aarch64-linux

  • x86_64-freebsd

    ,

    x86_64-windows

  • aarch64-windows

ソースからのビルド:

• Zig 0.15.2 が必要（異なるプラットフォーム対応時）。

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 ネイティブモジュール

• 見つからない場合、プリビルトかソースからのコンパイルを提案します。
• コントロール:

  • M-x ghostel-download-module

    : プリビルトダウンロード（最新版を使用）。

  • C-u M-x ghostel-download-module

    : タグ指定でダウンロード。

  • M-x ghostel-module-compile

    : ソースからのコンパイル。

3.6 Windows への注意

• ConPTY: ローカル端末は Windows ConPTY を使用します。ネイティブモジュールと並ぶ Microsoft のサポーターuntimeが探索されます。
• TRAMP: Windows からのリモート端末は POSIX 限定です。動的ウィンドウリサイズは未対応。

4. ソースからのビルド

git clone https://github.com/dakra/ghostel.git
cd ghostel
zig build --prefix . -Doptimize=ReleaseFast

• vendor/emacs-module.h

  が同梱されているため、ローカル Emacs ヘッダーは不要。
• Ghostty チェックアウトとの併用:

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

5. シェル統合

• bash, zsh, fish, nushell に対して OSC 7/133/2 を介して自動的に機能します。設定変更不要。
• nushell:

  ghostel.nu

  は追加機能のみを注入します。

  shell_integration.osc*

  が有効な必要があります。
• 手動注入無効化 (

  ghostel-shell-integration

  = nil):

  # fish
  string match -qr '^ghostel(,|$)' -- "$INSIDE_EMACS"; and source "$EMACS_GHOSTEL_PATH/etc/shell/ghostel.fish"
  # bash/zsh も同様
  

6. インプットモード詳細

C-c C-j

C-c M-d

C-c C-e

C-c C-t

C-c C-l

6.1 主要操作の鍵バインド

• C-c C-j

  : Semi-char モードへ（普遍的な退出）。

• M-RET

  : Char モードのみで Semi-char へ戻る。

• C-c M-n/p

  : 次の/前のプロンプトへ移動（Emacs モード内から）。

• C-c M-w

  : スクロールバック全体を Kill Ring にコピー。

6.2 マウス選択とモード遷移

• クリック＆ドラッグ時に入力モードが切り替わり、選択内容の保護が確保されます。
  • Copy: 再描画停止し選択安定。
  • Emacs: 読み取り専用だがライブ出力あり。
  • Nil: Semi-char で留まり、選択は可能だがコピー不可（プライマリ選択のみ）。

6.3 Line モードの詳細

• RET

  で一行全体をシェルへ送信します。
• TUI アプリ（vim, htop など）との共存的な動作を処理します。
• bash プログラマブル補完:

  ghostel-line-mode-use-bash-completion

  経由で有効化可能。

7. 機能一覧

• ターミナルエミュレーション: 256 色/RGB, OSC8/9/4/10/11 サポート、Kitty グラフィクス、同期出力（DEC 2026）。
• プロセスモデル: ネイティブ PTY（非同期処理）と Emacs PTY の両方をサポート。
• ブックマーク:

  C-x r m

  でディレクトリ・バッファ名を記録し再利用可能。
• リンク検出: OSC 8 ハイパーリンク、プレーン URL、ファイルパス（行指定）。
• クリップボード: OSC 52 サポート、括弧付きペースト。
• パスワードプロンプト:

  sudo

  /

  ssh

  のプロンプト自動検出と入力処理。メモリに暗号化される。
• 通知・プログレス: OSC 9/777 を認識し、

  alert

  パッケージなどを経由して表示。

7.10 インライン画像表示（Kitty グラフィクス）

• 伝統的配置（timg, kitty icat）とユニコードプレースホルダー配置の両方対応。
• 制限事項: アルファはstripされます。複数同時表示時は最新が優先。

8. TRAMP（リモート端末）

8.1 リモートシェル統合

オプション 1：自動注入（推奨）

(setq ghostel-tramp-shell-integration t)

• リモートホストに一時ファイルを作成してスクリプトを転送します。

オプション 2：マニュアル設定

• etc/shell/ghostel.{bash,zsh,fish,nu}

  をコピーし、ローカルシェルからソースします。

8.2 リモート xterm-ghostty terminfo

• 自動インストール:

  ghostel-ssh-install-terminfo

  が

  auto

  （デフォルト）の場合、必要に応じて自動で設定・キャッシュされます。
• 手動インストール:

  infocmp -x xterm-ghostty | ssh REMOTE 'mkdir -p ~/.terminfo && tic -x -'
  

9. 主な設定項目（カスタマイズ）

9.1 プロセスと環境

ghostel-term

"xterm-ghostty"

ghostel-use-native-pty

t

ghostel-kill-buffer-on-exit

t

9.2 パフォーマンス

ghostel-max-scrollback

5 MB

ghostel-timer-delay

0.033

9.3 機能制御

ghostel-enable-url-detection

t

ghostel-enable-osc52

nil

ghostel-detect-password-prompts

t

10. 拡張機能

10.1 Evil-mode

• evil-ghostel パッケージをロードすることで、Evil のナビゲーション（hjkl）と操作をサポートします。
• Insert ステートでは terminal カーソルがポイントと同期されます。

10.2 コンパイルモード (

ghostel-compile

)

• M-x ghostel

  と同じ環境でビルド結果を表示します。
• モード切り替え:

  • C-c C-j

    : インタラクティブ入力へ（read-prompt など）。

  • C-c C-e/t

    : 読み取り専用ナビゲーションへ戻ります。

• M-x ghostel-recompile

  で再実行可能。

10.3 Eshell 統合

• ghostel-eshell-visual-command-mode

  を有効化することで、可視コマンド（vim, htop など）を Ghostel バッファ内で実行できます。

11. コマンド一覧

M-x ghostel

M-x ghostel-clear

M-x ghostel-sync-theme

M-x ghostel-next-prompt

M-x ghostel-list-buffers

12. テストの実行

Makefile のターゲットを使用してください：

make test         # ERT テスト（ネイティブモジュール不要）
make test-native  # ネイティブモジュールを含むテスト

13. パフォーマンスの比較

ベンチマーク結果（Apple M4 Max, Emacs 32.0.50）:

• URL/ファイル検出はタイマーベースであり、通常動作へのオーバーヘッドはありません。

14. Ghostel vs vterm と eat

• libvterm 由来:

  emacs-libvterm

  とは異なり、よりモダンな

  libghostty-vt

  を採用。
• サポート機能: Kitty プロトコル、真色（24bit）、同期出力などが標準搭載。
• アーキテクチャ: ネイティブ PTY の非同期処理により、スループットとレイテンシが改善されています。