tmux-task-runner

What problem does it solve?

Developers often face challenges with long-running commands like builds, tests, or deployments that tie up their terminal, making it impossible to work on other tasks. This Skill eliminates that bottleneck by running these processes in the background, ensuring you never lose output and can monitor progress without interruption.

Core Features & Use Cases

• Detached Execution: Launch any command (e.g., npm run build, pytest, terraform apply) in a dedicated, isolated tmux session, freeing your terminal instantly.
• Persistent Logging & Status: All command output is saved to a timestamped log file, and execution metadata (exit code, duration) is recorded, even if your terminal closes.
• Real-time Monitoring: Easily check the status, tail logs, or attach to the session interactively to see live output, ensuring you're always informed without being blocked.
• Use Case: Initiate a complex CI/CD pipeline simulation or a machine learning model training session. You can then continue coding, reviewing, or even switch projects, knowing you can check the task's progress or final results at any moment.

Quick Start

Start a build process in the background

./run.sh run build "npm run build"

Monitor its progress (replace SESSION_ID with the actual session name)

./run.sh tail task-build-SESSION_ID

Check final status (replace SESSION_ID with the actual session name)

./run.sh status task-build-SESSION_ID