← All Toolkits

Remote Bash Tool

COMPOSIO_REMOTE_BASH_TOOLDestructiveExternal

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`.

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

Input parameters

commandstringRequired

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

session_idstring

Pass the session_id if you received one from a prior COMPOSIO_SEARCH_TOOLS call.

Response

dataobject

Data from the action execution

errorstring

Error if any occurred during the execution of the action

successfulboolean

Whether or not the action execution was successful or not