← Back to Skills Marketplace
brennerspear

Tmux

by BrennerSpear · GitHub ↗ · v1.0.0
darwinlinux ⚠ suspicious
583
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install tmux-controller
Description
Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
Usage Guidance
This skill appears internally consistent and does what it says: orchestrate and scrape tmux panes. Before installing, consider: - The skill uses the default tmux server and an 'oc-' naming convention; if you already run tmux sessions, the skill could accidentally target or kill sessions with conflicting names. Prefer running in a dedicated socket or separate user if you need isolation. - The skill drives arbitrary CLI processes inside tmux — do not run untrusted binaries via these sessions. Examples in the docs (like --dangerously-skip-permissions, --yolo, or --full-auto) are risky flags for real agent binaries; avoid using them unless you understand the implications. - The included wait-for-text.sh polls panes and can block until timeouts; review timeout settings to avoid long-running hangs. - If you need stronger containment, run tmux under a dedicated user, dedicated container, or use a custom socket (contrary to the skill's default recommendation) to avoid interacting with your interactive desktop/server tmux sessions. If you are comfortable with these caveats, the skill is coherent with its purpose.
Capability Analysis
Type: OpenClaw Skill Name: tmux-controller Version: 1.0.0 The `SKILL.md` instructions advise the AI agent to execute `claude` and `codex` with flags such as `--dangerously-skip-permissions`, `--full-auto`, or `--yolo`. These flags indicate a bypass of security checks or interactive confirmations, which, while not directly malicious actions by this skill, introduce a significant vulnerability by lowering the security posture of the applications run within `tmux` sessions. The `scripts/wait-for-text.sh` utility script appears robust against common shell injection vectors for its `grep` pattern argument.
Capability Assessment
Purpose & Capability
The skill only requires the tmux binary and its instructions and script exclusively use tmux commands (new-session, send-keys, capture-pane, kill-session). The included wait-for-text.sh polls tmux panes for text; this is directly aligned with 'remote-control tmux sessions'.
Instruction Scope
Instructions explicitly tell the agent to start and drive interactive programs inside tmux and to scrape pane output. This is expected for the stated purpose, but it means the skill will cause arbitrary commands to run inside user sessions (examples include launching 'claude'/'codex' with flags that bypass permissions). Also the guidance to always use the default tmux server means the skill will operate on the user's primary tmux server and could interact with or affect other user sessions if names collide.
Install Mechanism
No install spec; this is instruction-only plus a small included Bash helper script. Nothing is downloaded or written to disk beyond the provided script, so installation risk is low.
Credentials
The skill declares no required environment variables, credentials, or config paths. The SKILL.md examples reference running external agent binaries but do not request secret tokens from the environment.
Persistence & Privilege
always is false and the skill does not request persistent elevated privileges or modify other skills. It uses the default tmux server by design, which is a functional decision rather than a privilege escalation.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install tmux-controller
  3. After installation, invoke the skill by name or use /tmux-controller
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Auto-publish from CI
Metadata
Slug tmux-controller
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
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 583 downloads so far.

How do I install Tmux?

Run "/install tmux-controller" 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 (open-source). 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 BrennerSpear (@brennerspear); the current version is v1.0.0.

💬 Comments