pi-tmux-pane-title

Keep the current tmux pane title synchronized with the Pi session name.

Packages

Package details

extension

Install pi-tmux-pane-title from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-tmux-pane-title
Package
pi-tmux-pane-title
Version
0.2.0
Published
Aug 4, 2026
Downloads
123/mo · 123/wk
Author
patlux
License
MIT
Types
extension
Size
10.3 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

pi-tmux-pane-title

A small Pi extension that keeps the current tmux pane and window titles synchronized with the Pi session name.

This makes meaningful Pi names visible in plain tmux tabs and in tools such as TWS that use #{pane_title} as the agent display name.

Behavior

The extension runs on:

  • session_start — startup, resume, fork, new session, and reload
  • session_info_changed — /name and programmatic renames
  • agent_start — repairs titles overwritten by shells or other programs before work begins

It only acts when both TMUX and TMUX_PANE are present. Empty session names are ignored. The full name becomes the pane title. If the current window contains exactly one pane, a name shortened to 36 Unicode characters becomes the tmux window/tab name. Split windows are never renamed because no single Pi session can represent the whole window.

Titles are passed directly to tmux select-pane and tmux rename-window as arguments; no shell is involved. The last meaningful titles remain after Pi exits.

Install

From npm:

pi install npm:pi-tmux-pane-title

For a one-off test:

pi -e npm:pi-tmux-pane-title

Existing Pi processes need /reload or a restart after installation.

Development

npm install
npm run check

Override the tmux executable for testing if needed:

PI_TMUX_PANE_TITLE_TMUX_BIN=/path/to/tmux pi