@thinkscape/pi-status

A pi extension that shows a configurable status bar in the terminal tab title while pi is working, then restores the title when the turn finishes. Also supports Ghostty's native OSC 9;4 progress bar. Compatible with all libghostty-based terminals like cmux, muxy, etc.

Install

pi install @thinkscape/pi-status

Or test it for one run:

pi -e @thinkscape/pi-status

Screenshots

Main menu (/pi-status)

Component picker (/pi-status components)

Commands

Typing /pi-status with no arguments opens an interactive menu with these actions:

• Status: enabled/disabled — toggle pi-status on/off inline (press Enter/Space)
• Ghostty support: enabled/disabled — toggle Ghostty OSC 9;4 native progress bar
• Change components — open the component picker
• Change separator — change the separator character
• Reset to defaults — restore the default config
• Close — exit the menu

You can also invoke subcommands directly:

/pi-status                open interactive menu
/pi-status status         open interactive menu
/pi-status on             enable pi-status for this session
/pi-status off            disable pi-status for this session
/pi-status ghostty on     enable Ghostty progress bar
/pi-status ghostty off    disable Ghostty progress bar
/pi-status components     open TUI to toggle & reorder status components
/pi-status separator      change the separator character between elements
/pi-status reset          restore default pi-status configuration

components TUI

Opens an interactive picker with a live preview of the current title at the top. You can:

• Toggle components on/off with Space
• Reorder components with Ctrl+↑ / Ctrl+↓
• Navigate the list with ↑ / ↓
• Exit with Enter or Escape

The order in the list determines the display order in the tab title. Changes are saved immediately.

Available components

| Component ID | Description | Default | |-----------------|---------------------------------------|---------| | spinner | Progress spinner (⠋ ⠙ ⠹ ...) | on | | pi_symbol | π symbol | on | | session | Session name | on | | cwd | Working directory basename | on | | model | Current model (e.g., claude-sonnet-4-5) | off | | thinking | Thinking level (e.g., high) | off | | tokens | Context token usage | off | | turn | Current turn number | off | | git_branch | Current git branch name | off | | tools_count | Number of active tools | off | | current_tool | Currently executing tool name | off |

separator

Prompts for a new separator string (max 5 characters). The separator is placed between each enabled component.

Default: " - "

reset

Restores all pi-status configuration to the defaults shown above.

ghostty

Enables or disables Ghostty's native OSC 9;4 progress bar. When enabled:

• Indeterminate pulse while the agent is working (OSC 9;4;3), refreshed every second like pi's built-in terminal progress
• Green completion flash at 100% when the agent finishes (OSC 9;4;1;100)
• Clears on interaction (OSC 9;4;0) when you press a key, focus the terminal, start another agent turn, disable Ghostty support, or shut down pi

Works in Ghostty 1.2+ and any libghostty-based terminals. Enabled by default. The extension enables terminal focus reporting while Ghostty support is on and disables it on shutdown/reload.

Configuration

Settings are stored in pi's settings files under the piStatus key:

• ~/.pi/agent/settings.json (global)
• .pi/settings.json (project-local, overrides global)

Example with custom separator and additional components:

{
  "piStatus": {
    "separator": " | ",
    "ghosttySupport": true,
    "components": [
      { "id": "spinner", "enabled": true },
      { "id": "pi_symbol", "enabled": true },
      { "id": "model", "enabled": true },
      { "id": "session", "enabled": true },
      { "id": "cwd", "enabled": true },
      { "id": "thinking", "enabled": true },
      { "id": "git_branch", "enabled": true },
      { "id": "tokens", "enabled": false },
      { "id": "turn", "enabled": false },
      { "id": "tools_count", "enabled": false },
      { "id": "current_tool", "enabled": false }
    ]
  }
}

This would produce: ⠋ | π | claude-sonnet-4-5 | my-session | my-project | high | feat/config

Environment

Disable the extension by default:

PI_STATUS_DISABLED=1 pi

Accepted truthy values are 1, true, yes, and on.

Development

bun install
bun run check

Releasing

# Bump version only (patch/minor/major)
bun run version:patch

# Full release: check → bump → commit → tag
bun run release:patch

# Then push the tag to trigger GitHub Actions auto-publish:
git push origin main --tags

CI runs on every PR (bun run check + dry-run pack). Tag pushes trigger the publish workflow to npm.