Ghoztty
Open Source · macOS & Windows · 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.35.0 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, so teardown scripts are safe.

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.

With the Ghoztty plugin installed, Claude manages terminal windows for you.

1

Ask Claude to set up a workspace

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

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

macOS: download the DMG, drag Ghoztty to Applications, and launch it. Windows: run the per-user MSI — it upgrades an existing install in place. Either way Ghoztty sets up the ghoztty CLI for you and keeps it working after updates. No terminal commands, no admin password.

Download Ghoztty
Step 2

Add the Claude Skill

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

claude plugin marketplace add dzearing/ghoztty-claude-plugin
claude plugin install ghoztty@ghoztty-claude-plugin

That's it. Ask Claude to open windows, create splits, or tear down layouts. It handles the IPC commands automatically.

Ready to try?

Free and open source — signed and notarized on macOS, a per-user installer on Windows.

macOS DMG Apple Silicon · Signed & Notarized
Windows Installer x64 · Per-user, no admin

macOS v1.35.0 · macOS 13+ (Apple Silicon) · All releases

Windows v1.36.19 · Windows 10 1809+ (64-bit) · no installer? grab the portable ZIP

The Windows build is not code-signed, so SmartScreen shows “Windows protected your PC” the first time you run it. Choose Run anyway — on some versions of Windows that button is behind More info first. This is a way to override the warning, not a sign the file is trusted, so only do it for a download from this page.

On some machines Microsoft Defender goes further than a warning and quarantines the files, naming Trojan:Script/Wacatac.C!ml. The !ml ending means Defender’s machine-learning model guessed rather than matched a known threat, and a new unsigned program is exactly what it guesses about. To get the files back, open Windows Security → Protection history, find the Ghoztty item and choose Restore, then run the installer again. Every Windows build is compiled in the open by GitHub Actions from this repository’s release workflow, so you can check where your download came from before you do.