Skip to content
Ash

ash sandbox

Manage the Docker sandbox for secure command execution.

Usage

Terminal window
uv run ash sandbox COMMAND [OPTIONS]

Commands

build

Build the sandbox Docker image:

Terminal window
uv run ash sandbox build

Options:

  • --force, -f: Rebuild even if image exists

status

Check sandbox status:

Terminal window
uv run ash sandbox status

Shows:

  • Docker availability
  • Image status
  • Running containers

clean

Remove stopped containers:

Terminal window
uv run ash sandbox clean

Options:

  • --force, -f: Also remove the sandbox image

Examples

Initial setup:

Terminal window
uv run ash sandbox build
uv run ash sandbox status

Clean up containers:

Terminal window
uv run ash sandbox clean

Full cleanup including image:

Terminal window
uv run ash sandbox clean --force

Verification

For security verification, use pytest:

Terminal window
uv run pytest tests/test_sandbox_verify.py -v

For manual testing prompts, use the /test-sandbox skill.

Troubleshooting

Build fails

Ensure Docker is running:

Terminal window
docker info

Container issues

Check configuration:

Terminal window
uv run ash config show

Review the [sandbox] section for issues.