| name | tmux |
| description | Remote control tmux sessions for interactive CLIs, background tasks, and services. |
| license | MIT |
tmux Skill
Core Concepts
Socket: /tmp/pi-tmux-sockets/pi.sock (private, no conflicts with personal tmux)
Session Naming: pi-{category}-{name}-{timestamp}
- Categories:
task (temporary), service (long-running), agent (agent-specific)
Session States: running | idle | exited
Persistence: /tmp/pi-tmux-sessions.json
Auto-cleanup: Inactive sessions > 24h removed (configurable)
CLI Commands
bun ~/.pi/agent/skills/tmux/lib.ts <command>
create <name> <command> [category]
list [filter]
status <id>
send <id> <keys>
capture <id> [lines]
<>
cleanup [hours]
attach <>