tmuxlisted

# tmux Skill Use tmux as a programmable terminal multiplexer for interactive work, background tasks, and service management. Works on Linux and macOS with stock tmux; uses a private socket to avoid interfering with your personal tmux configuration. ## Quickstart (isolated socket) ```bash # Create a new session bun ~/.pi/agent/skills/tmux/lib.ts create my-task "echo 'Hello World'" task # List all sessions bun ~/.pi/agent/skills/tmux/lib.ts list # Capture output bun ~/.pi/agent/skills/tmux/lib.ts capture pi-task-my-task-20250107-123456 # Kill a session bun ~/.pi/agent/skills/tmux/lib.ts kill pi-task-my-task-20250107-123456 ``` ## Socket Convention - **Socket Directory**: `${TMPDIR:-/tmp}/pi-tmux-sockets` - **Default Socket**: `/tmp/pi-tmux-sockets/pi.sock` - **Environment Variable**: `PI_TMUX_SOCKET_DIR` (optional override) All Agent sessions use a private socket to avoid conflicts with your personal tmux configuration. ## Session Naming Sessions are named using the pattern: `pi-{category}-{name}-{timestamp}` - **Categories**: - `task`: Temporary sub-tasks (compilation, testing) - `service`: Long-running services (dev servers, databases) - `agent`: Agent-specific tasks (training, data processing) - **Examples**: - `pi-task-compile-20250107-123456` - `pi-service-dev-server-20250107-123456` - `pi-agent-training-20250107-123456` ## CLI Commands ### Create Session ```bash bun ~/.pi/agent/skills/tmux/lib.ts create <name> <command> [category] ``` Creates a