run-command

name	run-command
description	Execute a shell/terminal command and return the output. This skill should be used when the user wants to run a system command, script, or program from the terminal.

Run Command

Execute a shell command and capture its standard output and standard error.

Usage

python scripts/run_command.py "<command>"

Parameters

Parameter	Type	Required	Description
command	string	Yes	The shell command to execute

Behavior

• Executes the command in a subprocess with shell=True
• Captures stdout and stderr
• Returns stdout on success, stderr on failure
• Timeout: 30 seconds per command
• Security: Only execute commands that are safe and necessary

Notes

• Commands run with the same privileges as the Python process
• Avoid running destructive commands (rm, format, etc.) without confirmation
• Long-running commands will timeout after 30 seconds