Runs shell commands inside a dedicated tmux session named claw, captures, and returns the output, with safety checks for destructive commands.
Downloads
2.1k
Stars
1
Versions
1
Updated
2026-02-24
Install
npx clawhub@latest install claw-shell
Documentation
claw-shell
ALWAYS USES TMUX SESSION claw.
PURPOSE
- -RUN SHELL COMMANDS INSIDE TMUX SESSION
claw - -NEVER TOUCH ANY OTHER SESSION
- -READ OUTPUT BACK TO THE AGENT
INTERFACE
Tool: claw_shell_run
Inputs:
- -
command(string, required): shell command to run inside sessionclaw.
1. Attach to tmux session claw (create it if missing: tmux new -s claw -d).
2. Send the command followed by Enter.
3. Capture the latest pane output.
4. Return the captured output to the agent.
SAFETY
- -DO NOT RUN:
sudo
- rm (without explicit user approval)
- reboot, shutdown, or destructive system-level commands
- -IF THE COMMAND CONTAINS ANY OF THE ABOVE:
EXAMPLES
- -SAFE:
ls -la
- bird read https://x.com/...
- git status
- -DANGEROUS (ASK FIRST):
rm -rf ...
- docker system prune -a
- chmod -R ...
Launch an agent with claw-shell on Termo.