← Back to Skills Marketplace
Tmux Temp
by
zhouyaya100
· GitHub ↗
· v1.0.0
348
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install tmux-temp
Description
Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
Usage Guidance
This skill is coherent for controlling tmux sessions, but that capability is powerful: any tmux socket the agent can access allows it to run commands and read output as the socket owner. Before installing, ensure the agent runtime cannot reach other users' or sensitive tmux sockets (set CLAWDBOT_TMUX_SOCKET_DIR to a directory the agent controls, keep socket directory permissions restrictive, avoid running on multi-user hosts). Consider whether you want the agent to invoke the skill autonomously — if not, disable autonomous invocation for this skill. Review the scripts (they are short and readable) and avoid using the --all scan option unless you intend the agent to enumerate all sockets under the configured directory.
Capability Analysis
Type: OpenClaw Skill
Name: tmux-temp
Version: 1.0.0
The skill provides an AI agent with the capability to manage interactive tmux sessions and scrape their output, which is a high-risk capability that can be used to execute commands outside of standard monitored shell environments. While the scripts (scripts/find-sessions.sh and scripts/wait-for-text.sh) are well-authored and lack evidence of malicious intent, the SKILL.md documentation explicitly instructs the agent on how to orchestrate other agents (e.g., Codex) using flags like --yolo or --full-auto to bypass interactive safety confirmations. This combination of persistent background shell access and instructions to bypass sub-tool safety checks constitutes a high-risk capability set.
Capability Assessment
Purpose & Capability
Name/description (remote-control tmux sessions) match the declared requirements (tmux binary) and the provided scripts. The files implement listing sessions, polling pane output, sending keys and capturing panes — all expected for this purpose.
Instruction Scope
SKILL.md instructs the agent to list, attach to, send keystrokes to, and capture output from tmux sockets. That is exactly the intended functionality, but the instructions also include scanning 'all' sockets under the socket dir and recommend sending arbitrary commands to sessions (e.g., launching agents). Those behaviors are within scope but have sensitive side effects: any tmux socket the agent can access can be used to run commands and read output from other shells/processes on the host.
Install Mechanism
No install spec — instruction-only plus two small helper scripts. Nothing is downloaded or written by an installer; scripts are simple, readable shell code with no obfuscated payloads.
Credentials
No credentials or secret environment variables are requested. The only implicit config is CLAWDBOT_TMUX_SOCKET_DIR (a path for sockets), which is appropriate for locating tmux sockets.
Persistence & Privilege
Skill does not request 'always: true' or other elevated persistent privileges. It relies on tmux sockets accessible to the agent's runtime user; its privilege is therefore the same as any process that can access those sockets.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tmux-temp - After installation, invoke the skill by name or use
/tmux-temp - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
tmux-temp 1.0.0 initial release:
- Provides detailed documentation for controlling tmux sessions remotely by sending keystrokes and scraping pane output.
- Outlines conventions for socket management, session/pane targeting, and safe command input.
- Includes tips for orchestrating multiple coding agents in parallel using tmux sessions.
- Documents methods for monitoring, capturing output, and waiting for text in panes.
- Notes platform support (macOS/Linux) and Windows/WSL setup guidance.
- Offers cleanup instructions and details about helper scripts.
Metadata
Frequently Asked Questions
What is Tmux Temp?
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 348 downloads so far.
How do I install Tmux Temp?
Run "/install tmux-temp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tmux Temp free?
Yes, Tmux Temp is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Tmux Temp support?
Tmux Temp is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).
Who created Tmux Temp?
It is built and maintained by zhouyaya100 (@zhouyaya100); the current version is v1.0.0.
More Skills