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

デプロイメントと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.

主な機能

Comprehensive task status tracking including exit codes, timestamps, and duration
0 GitHub stars
Real-time log capture and persistent file-based logging for all processes
Automated session management with support for listing, monitoring, and cleanup
Detached background execution in isolated, named tmux sessions
Interactive session attachment for live debugging and manual control

ユースケース

Executing long-running test suites with persistent logging and status reporting
Managing development servers and deployment scripts that require persistent uptime
Running heavy build processes or compilation steps in the background

概要

主な機能

Comprehensive task status tracking including exit codes, timestamps, and duration
0 GitHub stars
Real-time log capture and persistent file-based logging for all processes
Automated session management with support for listing, monitoring, and cleanup
Detached background execution in isolated, named tmux sessions
Interactive session attachment for live debugging and manual control

ユースケース

Executing long-running test suites with persistent logging and status reporting
Managing development servers and deployment scripts that require persistent uptime
Running heavy build processes or compilation steps in the background