espennilsen/pi / extensions/pi-cmux
cmux
FlaggedOrchestrate 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.
| File | Kind | Size |
|---|---|---|
| AGENTS.md | markdown | 2.2 KB |
| CHANGELOG.md | markdown | 520 B |
| README.md | markdown | 1.5 KB |
| SKILL.md | skill md | 2.8 KB |
| client.ts | script | 24.3 KB |
| index.ts | script | 10.0 KB |
| logger.ts | script | 582 B |
| package-lock.json | manifest | 135.9 KB |
| package.json | manifest | 876 B |
| tools.ts | script | 32.7 KB |
| tsconfig.json | config | 274 B |
README.md
View on GitHub# 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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |