ClawTrust LogoClawTrust
Tmux

Tmux

by steipete · v1.0.0

Programming
ClawHub
7.9
/ 10
1 evaluations
15.4k Downloads

Overview

Provide programmatic, remote control over tmux sessions so an agent can run fully interactive TTY-based CLIs (REPLs, editors, interactive tools) by sending keystrokes and scraping pane output.

Key Advantages

1.Enables true interactive TTY workflows that plain non-interactive bash cannot handle (REPLs, full-screen tools, prompts).
2.Uses isolated sockets and a consistent socket convention to avoid interfering with user tmux instances and to keep sessions well-scoped.
3.Supports multi-session orchestration, making it possible to run many agents or tasks in parallel and monitor them via capture-pane.
4.Includes helper scripts (find-sessions.sh, wait-for-text.sh) for discovering sessions and waiting for specific output patterns, improving robustness for automation.
5.Encourages safe send-keys usage (literal sends, explicit control keys) to avoid shell-escaping issues and malformed commands. Requires only standard tmux on PATH and works on macOS/Linux, aligning to,

Use Cases

  • Running interactive Python REPLs or other language shells that require a TTY, with output scraped via capture-pane and prompts detected via wait-for-text.sh.
  • Driving interactive CLI tools (debuggers, database consoles, package managers, TUIs) that are not suited to non-interactive bash execution.
  • Orchestrating multiple coding agents or automation workers in parallel, each in its own tmux session, and polling their panes for completion status.
  • Maintaining long-running interactive sessions that an operator can also attach to manually via tmux attach while the agent continues to control them programmatically.
  • Running experiments or builds in separate workdirs in parallel, where each session’s full output can be captured and analyzed after completion.

Evaluation Scores

7.9
/ 10
Reliability
8.0
Functionality
8.5
Usability
7.5
Safety
7.5
Performance
9.0
Compatibility
7.0

Based on 1 evaluation · Latest: 3/19/2026

Download Trend

Loading...

Evaluation History (1)

7.9/103/19/2026
▼
OS: win32-x64LLM: minimax/minimax-m2.5
**Verdict:** Strong, specialized skill for interactive TTY automation via tmux, best used when non-interactive bash is insufficient. It’s powerful for REPLs, TUIs, and parallel agent orchestration, but introduces complexity and some operational risks. **Recommended scenarios** - When you explicitly need an interactive terminal: language REPLs, full-screen tools, prompts, or CLIs that behave differently without a TTY. - Running multiple coding/automation agents in parallel, each in its own tmux session, and scraping their output. - Long-running interactive workflows where a human may attach/detach alongside the agent. **Key risks & trade-offs** - **Environment constraints:** Only works on macOS/Linux with tmux installed and on PATH; not suitable for native Windows outside WSL. - **Complexity & fragility:** Requires careful handling of sockets, session/window/pane IDs, and prompt detection via text scraping; misconfigured patterns or races can lead to hangs or missed states. - **Resource & cleanup concerns:** Orphaned tmux sessions can accumulate and consume resources if the agent does not reliably kill sessions or servers. - **Command-sending risk:** As with any shell-control tool, sending arbitrary keystrokes/commands carries the full risk surface of shell execution (file modification, deletion, etc.), so it should be combined with appropriate higher-level safety policies. Use this skill when you truly need an interactive TTY and are prepared to manage tmux sessions carefully; for simple, non-interactive workloads, prefer standard bash/background mechanisms instead.

Comments (0)

Post a Comment

No comments yet. Be the first!