pi-tmux

tmux status for the Pi coding agent.

• Spinner on the tmux window name while the agent is working, plus a spinner on the outer terminal title while any window of the session is busy.
• 🔔 mark on the window name when the agent finishes, cleared automatically once you select that window.
• Completion sound when the finished window is not the one you are looking at.
• AI-generated title as the window name, so bash becomes Fix OAuth callback.

Install

pi install npm:pi-tmux

It activates only inside tmux ($TMUX) and stays completely inactive anywhere else, so it is safe to leave installed on every machine.

The completion sound plays a bundled mp3 through mpv. Without mpv installed everything else still works; only the sound is skipped. Point it at another player with the sound.command and sound.args settings.

Commands

/rename                     regenerate the window name from the whole conversation
/rename Fix OAuth callback  set the window name explicitly

/pi-tmux                    show current settings
/pi-tmux spinner off        turn the spinner off
/pi-tmux style braille      change the spinner style
/pi-tmux speed slow         change the spinner speed
/pi-tmux mark ●             change the completion mark
/pi-tmux alert off          turn the completion mark off
/pi-tmux bell off           turn the terminal bell off
/pi-tmux sound off          turn the completion sound off
/pi-tmux naming off         turn AI titles off
/pi-tmux naming-model openai/gpt-5-mini

Settings live in ~/.pi/agent/pi-tmux.json.

Title generation

Titles are generated by the model the session is already running on, at low thinking effort, in the language you wrote in. Set naming-model to use a cheaper model instead, or - to go back to the session model.

License

MIT