Skip to content

HazAT/pi-ghostty

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ghosttyv1.mp4

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

About

Ghostty terminal integration for Pi — dynamic title bar, progress indicators, and error states

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors