Skip to content

espennilsen/pi / extensions/pi-cmux

Orchestrate cmux terminal panes — split terminals, run parallel processes, read output from other panes, and use the built-in browser. Use when working inside cmux and you need to run a dev server, watch tests, spawn sub-agents, or preview web pages.

FileKindSize
AGENTS.mdmarkdown2.2 KB
CHANGELOG.mdmarkdown520 B
README.mdmarkdown1.5 KB
SKILL.mdskill md2.8 KB
client.tsscript24.3 KB
index.tsscript10.0 KB
logger.tsscript582 B
package-lock.jsonmanifest135.9 KB
package.jsonmanifest876 B
tools.tsscript32.7 KB
tsconfig.jsonconfig274 B
# pi-cmux

[cmux](https://cmux.dev) terminal app integration for [Pi](https://github.com/mariozechner/pi-coding-agent).

## 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 app.ts

The agent will:
1. `cmux_split` down → `npm run dev`
2. Edit `app.ts`
3. `cmux_read` the dev server pane to check for errors
4. Iterate until clean

## License

MIT
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall