Execute a shell command directly on the host system.
Commands are executed directly on your host system using subprocess.run()
with shell=True. There is no sandboxing, isolation, or security
restrictions. The command runs with your user's full permissions and can:
virtual_mode)Always use Human-in-the-Loop (HITL) middleware when using this method.
The command is executed using the system shell (/bin/sh or equivalent) with
the working directory set to the backend's root_dir. Stdout and stderr are
combined into a single output stream.
Shell command string to execute. Examples: "python script.py", "ls -la", "grep pattern file.txt"
Security: This string is passed directly to the shell. Agents can execute arbitrary commands including pipes, redirects, command substitution, etc.
Maximum time in seconds to wait for this command.
Overrides the default timeout set at init.
If None, uses the default.