> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Remote Bash Tool

> Execute bash commands in a REMOTE sandbox for file operations, data processing, and system tasks

**Slug:** `COMPOSIO_REMOTE_BASH_TOOL`

**Tags:** destructiveHint, openWorldHint

Runs bash commands in a remote sandbox for file operations, data processing, and system tasks.

## When to use it

Use `COMPOSIO_REMOTE_BASH_TOOL` to work with large tool responses that `COMPOSIO_MULTI_EXECUTE_TOOL` saved to remote files, or to run quick file and shell operations with tools like `jq`, `awk`, `sed`, and `grep`.

> [!NOTE]
>
> Commands run from `/home/user` by default and share the same 3-minute execution limit, so break large tasks into smaller commands.

## Input parameters

**command** `string` *required*

The bash command to execute. Hard 3-minute (180s) execution limit — break large tasks into smaller commands.

**session\_id** `string`

Pass the session\_id if you received one from a prior COMPOSIO\_SEARCH\_TOOLS call.

## Response

**data** `object`

Data from the action execution

**properties**

**session** `object`

Session info echoed back to reinforce reuse: \{ id: string, instructions: string }

**properties**

**id** `string`

**instructions** `string`

**stderr** `string`

The standard error output from the command, possibly truncated for brevity.

**stderrLines** `integer`

Total number of lines in original stderr, even if truncated

**stderr\_file\_path** `string`

Path to file containing full stderr if output was truncated

**stdout** `string`

The standard output from the command, possibly truncated for brevity.

**stdoutLines** `integer`

Total number of lines in original stdout, even if truncated

**stdout\_file\_path** `string`

Path to file containing full stdout if output was truncated

**sandbox\_id\_suffix** `string`

Last 4 digits of the sandbox ID for easier reference

**error** `string`

Error if any occurred during the execution of the action

**successful** `boolean`

Whether or not the action execution was successful or not
