# Pimux

> Thin trigger alias for the package-owned pimux runtime extension. Use for tmux-backed Pi agents with explicit bridge messaging and notify-first supervision.

- Skill: `waterplanai/pimux` (Agent Skill)
- Install (CLI): `npx skillmds add waterplanai/pimux`
- Raw SKILL.md: https://api.skillmd.com/api/skills/waterplanai/pimux/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: WaterplanAI (https://skillmd.com/u/waterplanai)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/waterplanai/pimux

---


# pimux

FIRST: do not poll pimux and do not use Bash sleep/wait loops; wait for delivered child activity.

This skill is a non-authoritative trigger shim for the package-owned `pimux` extension runtime. Runtime semantics are owned by `packages/pi-ac-workflow/extensions/pimux/` and its docs.

Use `/pimux` or the `pimux` tool to spawn and supervise tmux-backed Pi agents. The notification behavior is fixed to `notify-and-follow-up`.

See:
- `../../extensions/pimux/docs/commands.md`
- `../../extensions/pimux/docs/protocol.md`
- `../../extensions/pimux/docs/patterns.md`

Do not duplicate runtime protocol text here. Keep this alias minimal so package docs and extension prompts remain the single source of truth.