orq:shell tool runs commands in an isolated Linux sandbox. One sandbox is created lazily for the response and reused for later shell calls in the same response, so files and the working directory carry across commands.
Quick start
The examples use the client configuration from the Server tools overview.stdout and stderr values plus the exit code. Output that exceeds the configured length ends with [output truncated].
Configuration
The sandbox lasts only for the current response. Cross-request containers are not supported.
Availability and usage
The deployment must have a sandbox provider configured. This can be a cloud or on-premise sandbox provider that implements the Orq.ai sandbox interface. Shell has no separate server-tool charge in this release. Each attempted command appears atusage.server_tool_use.shell_commands, including calls blocked by max_uses.