---
title: "SandboxShell"
description: "Local-first visual environment for building and running AI workflows. Build agents visually, deploy anywhere, privacy by design."
canonical: https://docs.nodetool.ai/nodes/nodetool/sandbox/sandboxshell
markdown: https://docs.nodetool.ai/nodes/nodetool/sandbox/sandboxshell.md
product: NodeTool
source: https://github.com/nodetool-ai/nodetool/blob/main/docs/nodes/nodetool/sandbox/sandboxshell.md
---

# SandboxShell

**Type:** `nodetool.sandbox.SandboxShell`

**Namespace:** `nodetool.sandbox`

## Description

Execute shell commands in an isolated sandbox session.
    sandbox, shell, command, terminal, bash, execute, isolated

## Properties

| Property | Type | Description | Default |
|----------|------|-------------|---------|
| workspace_dir | `str` | Optional sandbox workspace directory. | `` |
| command | `str` | Shell command to execute in the sandbox. | `` |
| wait_seconds | `float` | If greater than 0, wait this long for output after launching command. | `1` |

## Outputs

| Output | Type | Description |
|--------|------|-------------|
| output | `str` |  |
| running | `bool` |  |
| exit_code | `union[int, none]` |  |
| timed_out | `bool` |  |

## Related Nodes

Browse other nodes in the [nodetool.sandbox](./) namespace.