---
slug: "pi-ghostty"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/HazAT/pi-ghostty@main/README.md"
repo: "https://github.com/HazAT/pi-ghostty"
source_file: "README.md"
branch: "main"
---

https://github.com/user-attachments/assets/70335937-849d-4404-89bf-5078cefe6efe


# pi-ghostty

A [Pi](https://github.com/badlogic/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](https://ghostty.org) 1.2+ (for native progress bar support)
- [Pi](https://github.com/badlogic/pi) coding agent

## Install

```bash
pi install npm:pi-ghostty
```

Or try it without installing:

```bash
pi -e npm:pi-ghostty
```

You can also install from git:

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

## How it works

The extension hooks into Pi's lifecycle events and writes [OSC escape sequences](https://ghostty.org/docs/vt) 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