ghostty-pane-splitter is a command-line interface (CLI) tool designed specifically for the Ghostty Terminal, facilitating seamless splitting of panes. This tool automates the pane splitting process by simulating keyboard inputs through the use of the enigo library, offering cross-platform compatibility across macOS and Linux.

Key Features

• Easy to use CLI tool for splitting terminal panes.
• Supports various layout specifications such as pane counts, grid specifications (COLSxROWS), or entirely custom arrangements.

Usage Examples

To use ghostty-pane-splitter, simply execute the following command:

ghostty-pane-splitter <LAYOUT>

Supported Layouts

The <LAYOUT> option can be utilized in several formats:

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

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

# Custom layout: 3 columns with 2, 1, 3 rows
ghostty-pane-splitter 2,1,3

Layout Examples

Configuration

ghostty-pane-splitter requires specific keybindings configured in the Ghostty terminal settings. Add the following lines to your Ghostty config file to ensure proper functionality:

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

The installation of Ghostty pane splitter is straightforward and can be quickly integrated into existing terminal setups, maximizing productivity by allowing users to efficiently manage multiple terminal sessions within a single window. For additional information and demonstration videos of the tool, please refer to the corresponding sections in this README.