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.
execute(
self,
command: str,
*,
timeout: int | None = None
) -> ExecuteResponse| Name | Type | Description |
|---|---|---|
command* | str | 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. |
timeout | int | None | Default: NoneMaximum time in seconds to wait for this command. Overrides the default timeout set at init. If None, uses the default. |