pi-ghostty

A Pi extension that brings Ghostty's native terminal features to life while you work. See at a glance what Pi is doing — which model is active, what tool is running, and whether things succeeded or failed.

Features

Dynamic window title — Shows your project directory and current model at a glance. Session name is included when set:

π my-project · claude-sonnet-4
π my-project · my-session · claude-sonnet-4

Animated spinner — A braille spinner animates in the title bar while the agent is working, so you know Pi is thinking even when the tab is in the background:

⠹ π my-project · claude-sonnet-4

Tool tracking — When a tool executes, the title swaps the model name for the active tool so you can see exactly what Pi is doing:

⠹ π my-project · bash
⠹ π my-project · read
⠹ π my-project · edit

Native progress bar — Uses Ghostty's built-in OSC 9;4 progress indicator:

• 🔵 Indeterminate pulse while the agent is thinking or running tools
• 🟢 Green completion flash (100%) when the agent finishes

Requirements

• Ghostty 1.2+ (for native progress bar support)
• Pi coding agent

Install

pi install npm:pi-ghostty

Or try it without installing:

pi -e npm:pi-ghostty

You can also install from git:

pi install git:github.com/HazAT/pi-ghostty

How it works

The extension hooks into Pi's lifecycle events and writes OSC escape sequences directly to /dev/tty, bypassing Pi's TUI to avoid any rendering interference.

| Pi Event | Title | Progress Bar | |----------|-------|-------------| | session_start | Set initial title | — | | model_select | Update model name | — | | agent_start | Start spinner | Indeterminate pulse | | tool_execution_start | Show tool name | — | | agent_end | Stop spinner | Green 100% → clear | | session_shutdown | — | Clear |

License

MIT