Ghoztty
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.22.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

Download the DMG, drag Ghoztty to Applications, and launch it. Ghoztty sets up the ghoztty CLI for you and keeps it working after updates. No terminal commands, no admin password.

Download for macOS
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, open source, signed and notarized for macOS.

macOS DMG Apple Silicon · Signed & Notarized

v1.22.0 · macOS 13+ · All releases

Remote Agent
for Windows.

Lets Ghoztty on your Mac open terminals on a Windows machine, from anywhere. The agent connects outbound over WSS and keeps itself up to date.

Windows

Install the agent

Download the installer (.msi)
  1. Run the downloaded Ghoztty-Agent-<version>-x64.msi. Per-user install, no admin required.
  2. Click Ghoztty Agent in the Start Menu.
  3. Sign in with Google in the browser that opens to link the machine to your account.

The agent keeps itself up to date automatically and starts at logon. Uninstall any time from Settings → Apps.

Advanced: headless install (PowerShell)

Paste into PowerShell on the Windows machine to install and enroll without the MSI.

irm https://ghoztty-relay-dz17575.westus2.cloudapp.azure.com/dl/install.ps1 | iex

Or download ghoztty-agent.exe directly.