pi-status-bar

A small Pi extension that replaces the default TUI footer with a theme-aware status bar showing git state and an AI-generated session summary.

Features

• Sticky footer for Pi's interactive TUI.
• Current working folder, git branch (or linked worktree name), git worktree marker, and pending change counts.
• AI-generated session title, refreshed as the conversation evolves.
• Graceful fallback session title when model auth or title generation is unavailable.
• Manual session title override with ctrl+shift+r or /session-bar-title.
• Resume-friendly session names via pi.setSessionName(...).
• Theme-aware colors using Pi theme tokens.
• No background timers in non-TUI/print mode.

Install

From npm:

pi install npm:@accolver/pi-status-bar

Or install directly from GitHub:

pi install git:github.com/accolver/pi-status-bar

After install, restart Pi or run:

/reload

Commands

/session-bar-title

Set the session title manually. Once set, AI title refreshes stop overwriting it.

/session-bar-clear-title

Clear a manually set session title and resume AI title updates.

/session-bar-refresh

Force-refresh git state and the AI session summary. Manual titles are preserved.

/session-bar-toggle

Toggle the status bar for the current session.

Shortcut

Press ctrl+shift+r to enter a manual session title. To change the shortcut, set PI_STATUS_BAR_TITLE_SHORTCUT or edit options.manualTitleShortcut in extensions/status-bar.ts.

How it works

The extension uses Pi's extension APIs:

• ctx.ui.setFooter(...) for the sticky TUI footer.
• pi.exec(...) for read-only git status checks.
• completeSimple(...) with the currently selected Pi model for short summaries, falling back to a local title if auth/model calls fail.
• pi.setSessionName(...) so /resume shows the generated session title.
• pi.appendEntry(...) to persist summary metadata without adding it to LLM context.

Package metadata

This repo is packaged for Pi with:

{
  "keywords": ["pi-package", "pi-extension"],
  "pi": {
    "extensions": ["./extensions/status-bar.ts"]
  }
}

License

MIT