PitchHut logo
ghostty-pane-splitter
Easily split panes in Ghostty Terminal with a simple CLI tool.
Pitch

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.

Description

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

InputResultDescription
22x12 columns
42x22x2 grid
63x23 cols x 2 rows
93x33x3 grid
2x32x3Explicit grid spec
1,31+3Left: 1 pane, Right: 3 panes
2,1,32+1+33 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.

0 comments

No comments yet.

Sign in to be the first to comment.