← Back to Skills Marketplace
Tmux Manager
by
Rocco De Angelis
· GitHub ↗
· v1.0.0
· MIT-0
114
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install tmux-manager
Description
Manage tmux sessions using the tmux-manager.py script. Use when asked to create, kill, restart, list, or inspect tmux sessions, send commands to sessions, ta...
Usage Guidance
This skill appears to do what it says — manage tmux sessions. Before installing or running it, review any tmux-sessions.yaml you will use: the config can contain pre_hook, post_hook, window/pane commands, and env values that will execute as shell commands or be injected into running terminals. Do not run untrusted configs or hooks as a privileged user. Use --dry-run and --validate first, inspect the sample YAML, and ensure uv and tmux are installed from trusted package sources. If you need to harden usage, avoid enabling hooks or limit configs to commands you control.
Capability Analysis
Type: OpenClaw Skill
Name: tmux-manager
Version: 1.0.0
The tmux-manager skill provides a functional utility for managing tmux sessions but contains high-risk patterns. Specifically, `scripts/tmux-manager.py` uses `subprocess.run(shell=True)` to execute `pre_hook` and `post_hook` commands defined in a YAML configuration file, creating a shell injection vulnerability if the config is untrusted. Additionally, the script's ability to send arbitrary strings to terminal panes (`--send-keys`) and the inclusion of sample commands in `SKILL.md` and `README.md` that use flags like `--dangerously-skip-permissions` represent a significant attack surface, although no clear evidence of intentional malice or data exfiltration was found.
Capability Assessment
Purpose & Capability
Name/description, required binaries (tmux, uv), script location, and usage all align: this is a tmux session manager that needs tmux and a script runner (uv). The brew installs for tmux and uv are reasonable for the stated functionality.
Instruction Scope
SKILL.md and the script confine behavior to a local YAML config and tmux operations. However the script supports pre/post hooks (run with shell=True) and arbitrary window/ pane commands (sent via tmux send-keys). Those features are expected for this tool but allow arbitrary shell execution and interaction with running sessions — review configs before running.
Install Mechanism
Install spec uses Homebrew formulas (uv, tmux). This is a low-risk, expected install mechanism for macOS/homebrew environments. No downloads from untrusted URLs or archive extraction are present.
Credentials
The skill requests no environment variables or external credentials. It does set tmux-level env vars from the YAML and expands user paths; that is reasonable and proportional to its functionality.
Persistence & Privilege
The skill is user-invocable, not always-enabled, and does not request elevated platform privileges or modify other skills. It will run subprocesses and hooks as the invoking user (normal for this type of utility).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tmux-manager - After installation, invoke the skill by name or use
/tmux-manager - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of tmux-manager.
- Provides a Python script to manage tmux sessions from a YAML config file.
- Supports creating, killing, restarting, listing, and inspecting tmux sessions.
- Allows targeting of sessions and windows using session groups and window groups.
- Includes commands to send input to sessions, tail pane output, and validate config files.
- Offers idempotent operation and a variety of selector/flag combinations for flexible control.
- Contains install instructions for required dependencies (uv, tmux).
Metadata
Frequently Asked Questions
What is Tmux Manager?
Manage tmux sessions using the tmux-manager.py script. Use when asked to create, kill, restart, list, or inspect tmux sessions, send commands to sessions, ta... It is an AI Agent Skill for Claude Code / OpenClaw, with 114 downloads so far.
How do I install Tmux Manager?
Run "/install tmux-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tmux Manager free?
Yes, Tmux Manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Tmux Manager support?
Tmux Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Tmux Manager?
It is built and maintained by Rocco De Angelis (@rdeangel); the current version is v1.0.0.
More Skills