← Back to Skills Marketplace
Tmux
by
utromaya-code
· GitHub ↗
· v1.0.1
· MIT-0
135
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install tmux-session-control
Description
Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
Usage Guidance
This skill is coherent with its purpose: it uses tmux to list sessions, capture pane text, poll for patterns, and send keystrokes. Before installing, consider: (1) tmux access equals the ability to read and send input to any tmux sessions the agent process can access — avoid using this skill on machines where other users' sensitive sessions may be available. (2) The scripts honor OPENCLAW_TMUX_SOCKET_DIR / CLAWDBOT_TMUX_SOCKET_DIR if set; ensure those env vars aren’t pointed at a broad or multi-user socket directory unless you intend the skill to scan them. (3) There are no network calls or credential requests, and no installer downloads. If you need stricter guarantees, review the two shell scripts yourself and run the agent under a user account that has only the intended tmux sessions available.
Capability Analysis
Type: OpenClaw Skill
Name: tmux-session-control
Version: 1.0.1
The skill bundle provides comprehensive control over tmux sessions, including listing sessions across various sockets, capturing pane output, and sending arbitrary keystrokes, which effectively grants the AI agent shell access. While the scripts `scripts/find-sessions.sh` and `scripts/wait-for-text.sh` appear well-authored and lack intentional malware or obvious vulnerabilities, the capability to programmatically interact with and send input to terminal sessions is a high-risk behavior. Per the provided criteria, risky capabilities like shell access are classified as suspicious even when they are aligned with the stated purpose of the skill.
Capability Assessment
Purpose & Capability
Name/description match the actual behavior: the SKILL.md and included scripts only require tmux and provide commands and wrappers to list sessions, capture pane output, poll for text, and send keys. There are no unrelated binaries, network endpoints, or credentials requested.
Instruction Scope
Runtime instructions explicitly show using tmux commands to capture output and send keystrokes. The scripts and examples operate on tmux sessions/panes only and do not instruct reading arbitrary files, calling external network services, or exfiltrating data. They do, as intended, read pane output and send input to sessions the agent can access.
Install Mechanism
No install spec or external downloads — the skill is instruction-only with two small shell scripts. Nothing is written to disk by an installer and no remote code is fetched.
Credentials
The scripts read optional environment variables (OPENCLAW_TMUX_SOCKET_DIR and CLAWDBOT_TMUX_SOCKET_DIR) to locate socket directories but these are not declared in requires.env. While this is not malicious, it means behavior can change if such env vars are set (for example enabling scan of all sockets under a directory via --all). The skill requests no credentials. Be aware that tmux access inherently allows reading/writing any sessions accessible to the user running the agent.
Persistence & Privilege
Skill is not always-enabled and does not modify other skills or system configuration. It requires only a user-level tmux binary and does not request elevated or persistent privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tmux-session-control - After installation, invoke the skill by name or use
/tmux-session-control - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
No changes detected in files for version 1.0.1.
- This release contains no code or documentation changes.
- Version bump only.
v1.0.0
Initial release of tmux-session-control skill.
- Remotely control tmux sessions by sending keystrokes and scraping pane output.
- Enables interactive CLI management, output monitoring, and programmatic navigation within tmux.
- Clear guidelines provided for when to use this skill vs. direct exec commands.
- Includes practical command examples for session management, output capture, sending input, and TUI safety tips.
- Tailored usage patterns for Claude Code/codex sessions.
Metadata
Frequently Asked Questions
What is Tmux?
Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output. It is an AI Agent Skill for Claude Code / OpenClaw, with 135 downloads so far.
How do I install Tmux?
Run "/install tmux-session-control" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tmux free?
Yes, Tmux is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Tmux support?
Tmux is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).
Who created Tmux?
It is built and maintained by utromaya-code (@utromaya-code); the current version is v1.0.1.
More Skills