Overview
The bash sandbox lets Taskade EVE and any Space Agent run approved commands against your app files in a safe, contained environment. Build small scripts, run quick checks, and have an agent execute them straight from chat.
TL;DR: Bash inside Space Agents runs commands against your app files in a sandbox. Use it for one-shot checks, repeatable scripts, and on-demand utilities. Output flows back into the chat thread so the agent can act on results. Pair with Custom AI Agents for a fully scripted teammate.
When to use the bash sandbox
Reach for bash when an agent needs to:
- Inspect or transform a file inside your Taskade Genesis app
- Run a repeatable script (lint, test, validate, format)
- Read a binary file like a PDF or image and pipe results into the next step
- Stitch together small utilities the agent does not have a built-in tool for
For everyday data shaping, prefer the Utility Actions so you stay declarative.
Set up bash for an agent
- Open the agent's edit screen.
- Scroll to Tools and enable Bash Sandbox.
- Pick the directories the agent can read or write inside the sandbox.
- Save and test by asking the agent to run a quick command.
The sandbox respects your workspace permissions, so an agent only sees what you grant it.
Safety controls
- Commands run inside an isolated sandbox, not on your host machine.
- Reads and writes stay scoped to the directories you select.
- Output streams back into chat so you can audit every step.
- Long-running commands hit a safety timeout to keep the sandbox responsive.
Binary file support
The sandbox reads binary files like images, PDFs, and audio out of the box. Agents can run a PDF text extractor, scan a screenshot, or summarize a media file without leaving the workflow. Pair with Image Generation to close the loop on visual workflows.
Related guides
- Taskade EVE Assistant. How Taskade EVE orchestrates tools and skills.
- Custom AI Agents. Build agents with specialized tools.
- Agent Knowledge. Train an agent on your documents.
- Agent Skills. Persisted slash-commands for repeat workflows.
- Agent Tools. All the tools an agent can call.
