ghostty-pane-splitter 0.1.1

CLI tool to split panes on Ghostty Terminal
ghostty-pane-splitter-0.1.1 is not a library.

ghostty-pane-splitter

CI crates.io License: MIT

日本語版 README はこちら

CLI tool to split panes on Ghostty Terminal.

Automates Ghostty's pane splitting by simulating keyboard inputs via enigo, enabling cross-platform support (macOS / Linux).

Installation

Homebrew (macOS)

brew install rikeda71/tap/ghostty-pane-splitter

curl (GitHub Releases)

# macOS (Apple Silicon)
curl -fsSL https://github.com/rikeda71/ghostty-pane-splitter/releases/latest/download/ghostty-pane-splitter-aarch64-apple-darwin.tar.gz | tar xz
sudo mv ghostty-pane-splitter /usr/local/bin/

# macOS (Intel)
curl -fsSL https://github.com/rikeda71/ghostty-pane-splitter/releases/latest/download/ghostty-pane-splitter-x86_64-apple-darwin.tar.gz | tar xz
sudo mv ghostty-pane-splitter /usr/local/bin/

# Linux (x86_64)
curl -fsSL https://github.com/rikeda71/ghostty-pane-splitter/releases/latest/download/ghostty-pane-splitter-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv ghostty-pane-splitter /usr/local/bin/

Cargo

cargo install ghostty-pane-splitter

From source

git clone https://github.com/rikeda71/ghostty-pane-splitter.git
cd ghostty-pane-splitter
cargo install --path .

Note: Linux requires libxdo-dev (sudo apt install libxdo-dev)

Usage

ghostty-pane-splitter <LAYOUT>

<LAYOUT> accepts either a pane count or a grid spec (e.g. COLSxROWS).

# Split into 4 panes (2x2 grid)
ghostty-pane-splitter 4

# Split into 6 panes (3x2 grid)
ghostty-pane-splitter 6

# Split into 2 cols x 3 rows
ghostty-pane-splitter 2x3

# Show version
ghostty-pane-splitter --version

# Show help
ghostty-pane-splitter --help

Layout examples

Input Result Description
2 2x1 2 columns
4 2x2 2x2 grid
6 3x2 3 cols x 2 rows
9 3x3 3x3 grid
2x3 2x3 Explicit grid spec

Configuration

This tool reads keybindings directly from your Ghostty config file. Add the following keybindings to your Ghostty config:

keybind = super+d=new_split:right
keybind = super+shift+d=new_split:down
keybind = super+ctrl+right_bracket=goto_split:next
keybind = super+ctrl+left_bracket=goto_split:previous
keybind = super+ctrl+shift+equal=equalize_splits

Ghostty config file locations:

  • macOS: ~/Library/Application Support/com.mitchellh.ghostty/config
  • Linux: ~/.config/ghostty/config

The tool will show an error if the config file is not found or required keybindings are missing.

Requirements

  • Ghostty terminal
  • Linux: libxdo-dev (sudo apt install libxdo-dev)

License

MIT