Open Source · macOS · Ghostty Fork

Your terminal,
agent-driven.

Ghoztty is a programmable fork of Ghostty that lets AI agents create windows, split panes, and manage layouts from the command line.

Download v1.6.1 View on GitHub

ide

nvim .

fn main() !void {

const app = init();

app.run();

}

term

$ zig build OK

$ _

logs

21:03:12 INFO server started

21:03:14 INFO ready on :8080

Terminal management
as an API.

Three idempotent CLI commands give agents full control over your terminal layout.

+new-window

Create or focus a named terminal window. Auto-launches Ghoztty if no instance is running. Idempotent by name.

+split

Split any pane in four directions. Name the new pane for later targeting. Nest splits to build complex layouts.

+close

Close a named pane or window by target. Closing a nonexistent target succeeds silently — safe for teardown scripts.

Named Targets

Every window and pane gets a name. Reference them from any command, any process. No PID tracking needed.

Colored Windows

Assign colors to windows and panes for instant visual identification. Keep track of your workspace at a glance.

Full Ghostty

GPU-accelerated rendering, native macOS integration, ligatures, sixel graphics — everything from Ghostty, plus IPC.

Works with
Claude Code.

Install the Ghoztty skill and Claude manages terminal windows for you.

Install the skill plugin

claude plugins add dzearing/claude-skills

Ask Claude to set up a workspace

"Open a terminal with nvim, a build watcher, and a log tail"

Claude creates the layout

# Claude runs these automatically:
ghoztty +new-window --target=ide --command="nvim ."
ghoztty +split --target=ide --name=build \
  --direction=down --command="zig build -Doptimize=Debug --watch"
ghoztty +split --target=ide --name=logs \
  --direction=right --command="tail -f app.log"

Get started
in two steps.

Step 1

Install Ghoztty

Download the latest DMG and drag to Applications. The ghoztty CLI is bundled inside the app.

            # After installing, set up the CLI in your PATH:
sudo ln -sf /Applications/Ghoztty.app/Contents/MacOS/ghoztty /usr/local/bin/ghoztty
          

Or build from source:

            git clone https://github.com/dzearing/ghoztty.git
cd ghoztty && zig build -Doptimize=ReleaseFast
          

Step 2

Add the Claude Skill

Install the skills plugin so Claude Code knows how to drive Ghoztty.