What problem does it solve?
Prevents long-running or indefinite commands from blocking your terminal session by moving them into a managed tmux background session with consistent logging and cleanup rules.
Core Features & Use Cases
- Background execution for long tasks: Run operations that take more than 2 minutes (installs, large test suites, training pipelines) without timing out.
- Indefinite server/task handling: Keep services and port-forwarding running in the background reliably.
- Failure-safe observability: Capture recent output (last 80 lines) without attaching, so you can debug while keeping your workflow non-intrusive.
- Safety-focused session hygiene: Enforce the agent- session naming convention, avoid attaching, and avoid killing tmux server or unrelated sessions.
Quick Start
Use the tmux-guide skill before starting a long command (for example, installing dependencies or running many tests) so the command is executed inside a tmux session named with the agent- prefix and you can later capture the last 80 log lines if needed.