One-click install
npx skills add https://github.com/MadeAgents/TopoClaw --skill tmux-madeagents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux
Source: https://github.com/MadeAgents/TopoClaw/tree/main/TopoClaw/topoclaw/skills/tmux
Command: npx skills add https://github.com/MadeAgents/TopoClaw --skill tmux-madeagents

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the difficulty of running interactive command-line sessions remotely while still capturing the resulting output for later processing.

Core Features & Use Cases

  • Remote-control tmux panes via keystrokes: Start tmux sessions and inject input safely using send-keys, including common control keys (e.g., Ctrl+C) for recovery.
  • Pane output scraping and prompt detection: Capture recent pane history and poll for specific text so an automation agent can react when an interactive prompt appears.
  • Session orchestration for parallel agents: Run multiple interactive coding agents in separate tmux sessions to parallelize work across work directories.

Use Case: When coordinating multiple coding agents (e.g., Codex/Claude Code) for bug fixes, use tmux to feed each agent its task, monitor completion by detecting a prompt, and then retrieve each agent’s final output.

Quick Start

Use the tmux skill to create an isolated tmux socket, start a detached session, send keystrokes to launch an interactive REPL, and capture pane output from the session.

Frequently Asked Questions about tmux

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate interactive CLI sessions and capture pane output remotely?

You can automate interactive CLI sessions by using tmux to create a detached session, inject keystrokes via send-keys, and capture pane output with capture-pane for downstream processing. This allows remote control while collecting live terminal output.

What is the best way to run parallel coding agents in separate terminal sessions?

Running parallel coding agents is achieved by orchestrating multiple tmux sessions. You can feed each interactive agent its task in a separate session, monitor completion by detecting prompt patterns, and retrieve the final output from each pane.

How do I detect when an interactive REPL prompt appears during terminal automation?

Prompt detection during terminal automation is handled by capturing recent pane history and polling for specific text patterns. The automation agent reacts when the target interactive prompt appears in the captured output.

Can I send control keys like Ctrl+C to recover an unresponsive interactive terminal session?

Yes, you can send control keys like Ctrl+C to recover unresponsive interactive terminal sessions. tmux send-keys supports injecting common control keys to safely interrupt and recover stuck REPL workflows.

Do I need an isolated tmux socket to safely run interactive command-line workflows?

Yes, an isolated tmux socket directory is required. Using an isolated socket ensures safe pane targeting, secure send-keys input injection, and reliable history capture when running interactive command-line workflows remotely.

What are the limitations of using tmux for remote REPL control and history capture?

Limitations of using tmux for remote REPL control include reliance on polling scripts for prompt detection and the need for pattern matching to verify completion. It targets Unix-like systems and requires careful send-keys input injection to avoid terminal corruption.