v1.0.0

claw-shell

imaginelogo imaginelogo ← All skills

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 session claw.
Behavior:

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:
- ASK USER FOR CONFIRMATION BEFORE EXECUTING.

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.