> ## Documentation Index
> Fetch the complete documentation index at: https://tbd-6fc993ce-hypeship-docs-website-deploy-hook.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# exec_command

> Run shell commands inside a browser VM

Execute a command synchronously inside a browser VM. Returns decoded stdout, stderr, and the exit code. The `command` field is the executable; pass its arguments in `args`.

## Parameters

| Parameter     | Description                                              |
| ------------- | -------------------------------------------------------- |
| `session_id`  | Browser session ID. Required.                            |
| `command`     | Executable to run (e.g., `cat`, `ls`, `curl`). Required. |
| `args`        | Arguments to pass to the command.                        |
| `cwd`         | Working directory (absolute path).                       |
| `as_root`     | Run with root privileges.                                |
| `timeout_sec` | Max execution time in seconds.                           |

## Example

```json theme={null}
{
  "session_id": "browser_abc123",
  "command": "curl",
  "args": ["-I", "https://example.com"]
}
```