← Back to Skills Marketplace
Tmux Steipete
by
SecureCloudProjO
· GitHub ↗
· v1.0.0
· MIT-0
83
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install tmux-steipete
Description
Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
Usage Guidance
This skill appears to do what it says (control tmux sessions) and only requires tmux, but review before installing:
- Metadata mismatch: the embedded _meta.json ownerId differs from the registry ownerId — that suggests copy/paste or packaging issues; verify the publisher identity if that matters to you.
- Socket targeting is powerful: the scripts accept arbitrary socket paths and a --all scan mode. If the socket directory is shared (e.g., a world-writable /tmp path or system tmux socket), the skill could list, read, and send keystrokes to other users' tmux sessions — effectively running commands in their shells. Only run this skill in an isolated environment or ensure CLAWDBOT_TMUX_SOCKET_DIR points to a private socket directory.
- The SKILL.md references CLAWDBOT_TMUX_SOCKET_DIR but the skill metadata doesn't declare it; treat that env var as required configuration and confirm its value before use.
- No network exfiltration endpoints or hidden downloads were found in the files, but the core capability (send-keys, capture-pane) is inherently sensitive. If you plan to allow autonomous agent invocation, be cautious: an agent could use this skill to control local shells if given socket paths.
If you want to proceed: verify the publisher, restrict the socket directory to a private location, and test in a non-production environment first.
Capability Analysis
Type: OpenClaw Skill
Name: tmux-steipete
Version: 1.0.0
The skill provides a set of utility scripts and instructions for managing tmux sessions, enabling an AI agent to interact with terminal-based applications. It includes helper scripts for listing sessions (`find-sessions.sh`) and polling pane output for specific text (`wait-for-text.sh`), while recommending the use of isolated sockets in temporary directories to maintain environment hygiene. No evidence of malicious intent, data exfiltration, or unauthorized persistence was found.
Capability Assessment
Purpose & Capability
Name/description, required binary (tmux), scripts, and runtime instructions align with a tool to control tmux sessions. The ability to list, capture, and send keystrokes is expected for this purpose. However, the skill exposes optional scanning of multiple sockets (--all) which — if pointed at a shared socket directory — can enumerate other users' sessions; that is a sensitive capability but coherent with the stated goal.
Instruction Scope
SKILL.md and the included scripts instruct the agent to send keystrokes and scrape pane output (capture-pane), which is exactly the advertised functionality. The instructions reference an environment variable CLAWDBOT_TMUX_SOCKET_DIR (and allow arbitrary -S socket paths) even though requires.env is empty; this gives the agent scope to target any tmux socket path the operator or agent supplies, which could lead to accessing or controlling unrelated sessions if misused.
Install Mechanism
No install spec; this is instruction+script-only and requires tmux on PATH. Nothing is downloaded or extracted from external URLs.
Credentials
The registry lists no required env vars, but SKILL.md and the scripts rely on CLAWDBOT_TMUX_SOCKET_DIR (with a TMPDIR fallback). That environment dependency is reasonable for socket location, but it's not declared in the metadata. No credentials or unrelated environment access is requested.
Persistence & Privilege
always:false and there is no install-time modification of other skills or global agent settings. The skill does not request persistent privileges beyond using tmux sockets accessible to the process.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tmux-steipete - After installation, invoke the skill by name or use
/tmux-steipete - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the tmux skill for Clawdbot.
- Remote-controls tmux sessions for interactive CLI tasks by sending keystrokes and capturing output.
- Follows predictable socket convention and pane targeting for reliability.
- Includes best practices for monitoring, sending input, and handling Python REPLs.
- Provides helper scripts for session discovery and prompt detection.
- Supports orchestration of multiple coding agents in parallel.
- Documents safe cleanup procedures for sessions and sockets.
Metadata
Frequently Asked Questions
What is Tmux Steipete?
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 83 downloads so far.
How do I install Tmux Steipete?
Run "/install tmux-steipete" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tmux Steipete free?
Yes, Tmux Steipete is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Tmux Steipete support?
Tmux Steipete is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).
Who created Tmux Steipete?
It is built and maintained by SecureCloudProjO (@securecloudprojo); the current version is v1.0.0.
More Skills