How does Claude know when a background tmux task is finished?

The skill includes a 'wait-for-text' helper script that polls the terminal pane for specific patterns, such as a shell prompt or a success message.

Can I monitor the sessions manually?

Yes, the skill provides socket paths and attach commands, allowing you to manually attach to the sessions Claude is managing to see the work in progress.

Why use tmux instead of standard bash commands?

tmux is used for interactive CLI tools and TTY sessions that require specific keystroke interactions or need to persist independently of the main process.

Does this skill require tmux to be installed?

Yes, the tmux skill requires the tmux binary to be available on your system's PATH. It is supported on macOS, Linux, and Windows via WSL.

Is it safe to run multiple agents at once with this skill?

Yes, it uses isolated sockets and session naming conventions to ensure that multiple agents can work in parallel without interfering with each other's terminal input or output.

Tmux Automation & Orchestration

Name: Tmux Automation & Orchestration
Author: ishuru

byishuru

Productivity & Workflow

Automates tmux sessions to manage interactive CLI tools, long-running background processes, and multi-agent orchestration.

About

The tmux skill enables Claude to interact with terminal multiplexers by sending keystrokes and scraping pane output, providing a bridge between the AI and interactive TTY environments. It is specifically designed for scenarios where standard non-interactive bash tools fail, such as managing persistent Python REPLs or orchestrating a fleet of parallel coding agents. By utilizing isolated socket conventions and automated text monitoring, this skill allows for complex terminal workflows that persist across sessions and require real-time output observation.

Key Features

Orchestrate multiple parallel coding agents in isolated tmux sessions.
Isolated socket management to prevent session conflicts and ensure clean resource cleanup.
0 GitHub stars
Automated polling with wait-for-text scripts to detect prompt changes or task completion.
Scrape and capture historical pane output for real-time monitoring and debugging.
Remote-control interactive TTY sessions by sending literal keystrokes and control sequences.

Use Cases

Running and interacting with a persistent Python REPL in a controlled environment.
Managing long-running background tasks that require periodic status checks via TTY.
Parallelizing complex code fixes across multiple directories using multiple AI agents.

About

Key Features

Orchestrate multiple parallel coding agents in isolated tmux sessions.
Isolated socket management to prevent session conflicts and ensure clean resource cleanup.
0 GitHub stars
Automated polling with wait-for-text scripts to detect prompt changes or task completion.
Scrape and capture historical pane output for real-time monitoring and debugging.
Remote-control interactive TTY sessions by sending literal keystrokes and control sequences.

Use Cases

Running and interacting with a persistent Python REPL in a controlled environment.
Managing long-running background tasks that require periodic status checks via TTY.
Parallelizing complex code fixes across multiple directories using multiple AI agents.