pi-tmux-bell
Pi extension that sends cmux notifications when Pi finishes or needs input
Package details
Install pi-tmux-bell from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-tmux-bell- Package
pi-tmux-bell- Version
0.1.1- Published
- Aug 12, 2026
- Downloads
- 185/mo · 10/wk
- Author
- satyam-mishra
- License
- MIT
- Types
- extension
- Size
- 5.3 KB
- Dependencies
- 0 dependencies · 1 peer
Pi manifest JSON
{
"extensions": [
"./extensions/index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-tmux-bell 🔔
A Pi extension that sends a real cmux notification when Pi finishes a prompt or needs an answer.
Why?
When you switch away from a Pi session in cmux, this extension uses cmux notify rather than writing a terminal bell character. cmux routes that through its notification system, where it can play the configured notification sound and provide an actionable notification for the current surface.
Installation
pi install npm:pi-tmux-bell
Requirements
- Run Pi inside cmux. The extension detects cmux from its environment and otherwise does nothing.
- Enable cmux desktop-notification permission and its notification sound in cmux Settings if you want an audible chime.
How It Works
The extension uses Pi's lifecycle events:
agent_settled— fires only after the agent run has fully settled: no automatic retry, compaction, or queued continuation remains. This produces one “Ready for input” notification per completed prompt.tool_execution_start— sends an early notification when a supported interactive question tool (ask_user_question/AskUserQuestion) begins waiting for an answer.
It intentionally does not use turn_end: that event fires after each model/tool iteration, which is why earlier versions notified after every command.
Why not BEL?
A BEL (\x07) is a terminal-control character. cmux treats it as a terminal bell, which can create visual/Dock attention, not as a cmux agent notification. cmux notify is the app-level mechanism used by cmux's own agent integrations.
License
MIT