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

0•

생산성 및 워크플로

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

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.

주요 기능

01Orchestrate multiple parallel coding agents in isolated tmux sessions.

02Isolated socket management to prevent session conflicts and ensure clean resource cleanup.

030 GitHub stars

04Automated polling with wait-for-text scripts to detect prompt changes or task completion.

05Scrape and capture historical pane output for real-time monitoring and debugging.

06Remote-control interactive TTY sessions by sending literal keystrokes and control sequences.

사용 사례

01Running and interacting with a persistent Python REPL in a controlled environment.

02Managing long-running background tasks that require periodic status checks via TTY.

03Parallelizing complex code fixes across multiple directories using multiple AI agents.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ishuru/ishuru tmux

For use in Claude.ai and ChatGPT

Download Skill