ghostty pane splitter — Easily split panes in Ghostty…

Pitch

Description

Comments

About this project

Ghostty-pane-splitter is a command-line interface tool designed to streamline the process of splitting panes on the Ghostty terminal. By simulating keyboard inputs, it allows for seamless pane configurations across platforms, making it easy to set up custom layouts that enhance productivity and workflow.

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

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
`1,3`	1+3	Left: 1 pane, Right: 3 panes
`2,1,3`	2+1+3	3 columns with 2, 1, 3 rows

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.

Visit ghostty-pane-splitter