@tmustier/pi-session-hud

Persistent session HUD widget for Pi (below-editor bar with git/context/model/activity).

Package details

← Back
extension

Install @tmustier/pi-session-hud from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@tmustier/pi-session-hud
Package
@tmustier/pi-session-hud
Version
0.1.6
Published
Apr 23, 2026
Downloads
158/mo · 123/wk
Author
tmustier
License
MIT
Types
extension
Size
24.6 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "pi-session-hud.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

/hud — Session HUD

A Pi extension that adds a persistent heads-up display below the editor (above Pi’s built-in footer).

Demo

Session HUD demo

Full-quality MP4: https://raw.githubusercontent.com/tmustier/pi-session-hud/main/assets/demo.mp4

HUD placement (below editor/input, above footer):

HUD placement

(Hosted on GitHub so npm users see the media in README, but npm install stays small.)

What it shows

  • Activity state (idle / running / tool / error / stale)
  • Session name (or cwd) and first user message fallback
  • Git branch + worktree marker (⎇ name current/total when multiple) + diff stats
  • Context usage (% + tokens)
  • Current model (+ thinking level)

Install

Pi package manager (npm)

pi install npm:@tmustier/pi-session-hud

Pi package manager (git)

pi install git:github.com/tmustier/pi-session-hud

Local clone

Symlink into Pi’s auto-discovered extensions directory:

ln -s ~/pi-session-hud/pi-session-hud.ts ~/.pi/agent/extensions/

Or add to ~/.pi/agent/settings.json:

{
  "extensions": ["~/pi-session-hud/pi-session-hud.ts"]
}

Usage

In Pi:

  • Toggle HUD: /hud
  • Aliases: /status, /header

Notes

  • Uses ctx.ui.setWidget(..., { placement: "belowEditor" }) so it’s not the footer and not a header.
  • Git stats are refreshed every ~10s via git diff --stat HEAD + git status --porcelain.

Changelog

See CHANGELOG.md.