Where are my task logs and status files stored?

By default, logs and status metadata are stored in /tmp, but you can configure custom directories using the LOG_DIR and STATUS_DIR environment variables.

How do I monitor a task that is already running?

You can use the built-in tail helper provided by the skill, use 'tail -f' on the specific log file, or use 'tmux attach-session' to enter the live session.

Why use tmux for background tasks instead of standard shell backgrounding?

Tmux provides a persistent environment that survives shell disconnections, allows you to re-attach to the interactive session for debugging, and offers superior output capture through pane buffers.

Can I pass custom environment variables to my background tasks?

Yes, the skill supports environment variable injection via the --env flag, allowing you to set specific configurations for individual runs.

What happens if tmux is not installed on my system?

The skill includes a validation step that checks for tmux. If it is missing, Claude will provide you with the specific installation commands for your operating system.

Tmux Task Runner

Name: Tmux Task Runner
Author: shanev

byshanev

0•

Despliegue y DevOps

Manages long-running background processes and build tasks using persistent tmux sessions with integrated logging and monitoring.

The tmux-task-runner skill enhances Claude's ability to handle complex asynchronous workflows by executing builds, test suites, and deployment scripts in detached tmux sessions. It provides a robust environment for background execution, offering real-time output monitoring via log tailing or session attachment, while automatically capturing critical metadata like exit codes and execution duration. This skill is ideal for developers who need to run time-consuming operations without blocking their primary terminal or risking task failure due to session timeouts.

Características Principales

01Comprehensive task status tracking including exit codes, timestamps, and duration

020 GitHub stars

03Real-time log capture and persistent file-based logging for all processes

04Automated session management with support for listing, monitoring, and cleanup

05Detached background execution in isolated, named tmux sessions

06Interactive session attachment for live debugging and manual control

Casos de Uso

01Executing long-running test suites with persistent logging and status reporting

02Managing development servers and deployment scripts that require persistent uptime

03Running heavy build processes or compilation steps in the background

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add shanev/skills tmux-task-runner

For use in Claude.ai and ChatGPT

Download Skill