Is it safe for my existing tmux sessions?

Yes, it uses a dedicated socket directory (claude-tmux-sockets) to ensure the agent's sessions remain completely isolated from your personal tmux server.

How does the AI know when a command has finished?

The skill uses a helper script called wait-for-text.sh which polls the terminal pane for specific output patterns or prompts before proceeding.

Can I watch what the AI is doing in the tmux session?

Yes, the skill explicitly provides monitor commands you can copy and paste to attach to the session or capture the output in real-time.

Does this skill require a custom tmux configuration?

No, the skill is designed to work with stock tmux on Linux and macOS, utilizing private sockets and clean configurations to avoid interference with your local setup.

Tmux Terminal Multiplexer

Name: Tmux Terminal Multiplexer
Author: mitsuhiko

bymitsuhiko

•

430

•

Developer Tools

Manages interactive terminal sessions and long-running processes through programmatic tmux control and pane scraping.

This skill enables Claude to interact with complex Command Line Interfaces (CLIs) that require persistent sessions, such as Python REPLs, GDB debuggers, and interactive shell processes. By utilizing isolated tmux sockets, it allows the agent to send keystrokes, monitor output in real-time, and scrape pane history without interfering with the user's local tmux configuration. This is essential for tasks requiring a stateful terminal environment where simple one-off command execution is insufficient for debugging or iterative data analysis.

Key Features

01Programmatic keystroke injection for interacting with persistent REPLs

02430 GitHub stars

03Isolated socket management to prevent session conflicts with user environments

04Specialized recipes for interactive debugging with GDB and LLDB

05Real-time pane output scraping with regex-based synchronization

06Automated session cleanup and lifecycle management

Use Cases

01Managing stateful Python REPLs for iterative data exploration and script testing

02Automating interactions with interactive CLI tools like database shells or network monitors

03Interactive debugging of C/C++ applications using GDB within a persistent session

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mitsuhiko/agent-commands tmux

For use in Claude.ai and ChatGPT

Download Skill