← Back to Skills Marketplace
cuba6112

Tmux Agents

by cuba6112 · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
3049
Downloads
6
Stars
10
Active Installs
1
Versions
Install in OpenClaw
/install tmux-agents
Description
Manage background coding agents in tmux sessions. Spawn Claude Code or other agents, check progress, get results.
Usage Guidance
This skill is coherent with its stated purpose, but review and consider the following before installing or running it: - Review scripts (spawn.sh) locally: it cd's to ~/clawd — adjust or remove that if you don't want the agent working directory to be your home/project path. - Be cautious about the agent CLI flags: --dangerously-skip-permissions, --auto-edit and --full-auto can make agents accept permissions or apply edits automatically. Use them only if you trust the agent and understand the consequences. - The skill relies on external CLIs (claude, codex, gemini, ollama). Ensure those CLIs are installed and configured with the correct API keys/credentials; the skill does not declare or manage those credentials. - Treat agent names and custom commands as executable input: if you pass untrusted strings as the agent argument they will be invoked as commands inside tmux. Avoid using this skill with untrusted inputs. - Test in a safe environment first (a throwaway repo or container) and avoid running as a privileged user. If you want to limit risk, remove or alter the auto-approve flags and the hardcoded cd before using. If you want me to, I can suggest a safer spawn.sh variant that omits auto-approve flags, validates inputs, and uses a configurable working directory instead of ~/clawd.
Capability Analysis
Type: OpenClaw Skill Name: tmux-agents Version: 1.0.0 The skill bundle is classified as suspicious due to a potential command injection vulnerability in `scripts/spawn.sh`. The script's `case` statement includes a default `*)` block that directly executes the `$AGENT` variable with the `$TASK` as an argument (`$AGENT "$TASK"`). If an attacker can leverage prompt injection against the OpenClaw agent to pass an arbitrary string as the `AGENT` parameter (e.g., `'; rm -rf /; echo '`), it could lead to arbitrary command execution on the host system. Although `SKILL.md` defines a limited set of valid agents, the script itself does not enforce this validation, creating a significant risk if the calling agent can be coerced into providing malicious input.
Capability Assessment
Purpose & Capability
Name/description, required binary (tmux), the brew install of tmux, and included scripts align with a tool that spawns and manages tmux-based agent sessions. Using external agent CLIs (claude, codex, gemini, ollama) is consistent with the stated purpose.
Instruction Scope
spawn.sh sends commands into tmux that launch external CLIs and runs them with flags like --dangerously-skip-permissions and --auto-edit/--full-auto which may cause agents to accept permissions or auto-apply edits without interactive confirmation. The script also unconditionally cds to ~/clawd (a hardcoded path) which is not documented as required and may cause unexpected behavior or operate on files in that directory.
Install Mechanism
Install uses a Homebrew formula for tmux, a well-known package source; nothing is downloaded from an arbitrary URL and no archive extraction is used. This is low risk.
Credentials
The skill declares no required env vars or credentials, but the runtime expects external agent CLIs that typically require API keys/config (cloud agents). Those credentials are not requested or documented as required environment variables — the scripts assume the user has preconfigured CLIs. Also the hardcoded ~/clawd path is an implicit config that wasn't declared.
Persistence & Privilege
always is false and the skill does not request elevated or persistent platform-wide privileges, nor does it modify other skills or global agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install tmux-agents
  3. After installation, invoke the skill by name or use /tmux-agents
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: spawn Claude, Codex, Gemini agents + Ollama local variants in tmux sessions
Metadata
Slug tmux-agents
Version 1.0.0
License
All-time Installs 11
Active Installs 10
Total Versions 1
Frequently Asked Questions

What is Tmux Agents?

Manage background coding agents in tmux sessions. Spawn Claude Code or other agents, check progress, get results. It is an AI Agent Skill for Claude Code / OpenClaw, with 3049 downloads so far.

How do I install Tmux Agents?

Run "/install tmux-agents" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Tmux Agents free?

Yes, Tmux Agents is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Tmux Agents support?

Tmux Agents is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Tmux Agents?

It is built and maintained by cuba6112 (@cuba6112); the current version is v1.0.0.

💬 Comments