tmux-guide

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.