@e9n/pi-cmux

cmux terminal app integration for pi — notifications, pane management, screen reading, and browser automation

Package details

← Back
extension

Install @e9n/pi-cmux from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@e9n/pi-cmux
Package
@e9n/pi-cmux
Version
0.1.1
Published
Apr 26, 2026
Downloads
50/mo · 50/wk
Author
e9n
License
MIT
Types
extension
Size
70.3 KB
Dependencies
0 dependencies · 2 peers
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-cmux

cmux terminal app integration for Pi.

What it does

When Pi runs inside a cmux terminal, this extension automatically:

  • Notifies you when the agent finishes (blue ring on cmux tab + desktop notification)
  • Shows status in the cmux sidebar (thinking, running tools, idle)
  • Gives the agent tools to split panes, read other terminals, send commands, and control cmux's built-in browser

Detection

The extension auto-detects cmux via environment variables (CMUX_WORKSPACE_ID, CMUX_SURFACE_ID) and the Unix socket at /tmp/cmux.sock. Outside cmux, it does nothing.

Tools

Tool Description
cmux_list List all panes and workspaces
cmux_split Split terminal, optionally run a command
cmux_read Read output from another pane
cmux_send Send text or keystrokes to another pane
cmux_close Close a pane
cmux_notify Desktop notification
cmux_browser Browser automation (open, snapshot, click, fill, eval)

Commands

Command Description
/cmux-status Show cmux connection info

Shortcuts

Shortcut Description
Ctrl+Shift+W Quick pane switcher

Example: dev server + coding

Ask the agent:

Start a dev server in a split pane, then fix the bug in src/app.ts

The agent will:

  1. cmux_split down → npm run dev
  2. Edit src/app.ts
  3. cmux_read the dev server pane to check for errors
  4. Iterate until clean

License

MIT