---
title: "Sandbox in the CLI"
canonical: https://trickest.com/docs/developer-tools/cli/sandbox
description: "Current compatibility limits for the CLI sandbox session commands and the standalone SDK alternative."
---

# Sandbox in the CLI

The `trickest sandbox` command family targets **platform sandbox sessions**. It is not a command-line wrapper around the standalone `@trickest/sandbox` package.

<Warning>
The sandbox commands do not fully match the platform API. Use the [Sandbox SDK](/docs/developer-tools/sandbox-sdk) for direct environment control.
</Warning>

## Current limitations

| Command | Compatibility issue |
| --- | --- |
| `sandbox start` | Does not send the owning workflow or agent-session context required by the API |
| `sandbox status` | Uses an incompatible route instead of the platform's context-based status endpoint |
| `sandbox exec`, `sandbox files`, `sandbox stop` | Do not reliably supply the execution session ID required for these operations |
| `sandbox logs` | Session log streaming is unsupported; `--follow` is not a working log stream |

An HTTP error from these commands is not proof that your token is invalid or that no sandbox exists. Changing credentials or repeatedly creating environments does not correct an incompatible client request.

## Command output

For detached command logs today, use the dedicated SDK's command handles as described in [Commands and output](/docs/developer-tools/sandbox-sdk/commands). Command logs are different from a platform session-wide log stream.

## Lifecycle

A platform session is associated with a workflow or agent session. Its execution session ID is required for commands, files, and disposal. A cold start can return before the machine is ready; a successful HTTP response alone does not establish readiness.

Stopping a platform sandbox session disposes of its execution environment. Durable platform workspace state is managed separately. Copy important output outside the disposable filesystem before cleanup. See [Platform SDK sandbox sessions](/docs/developer-tools/sdk/sandbox) for IDs, readiness, and retention.

## Related

- [Sandbox SDK](/docs/developer-tools/sandbox-sdk): create, run, collect, and delete from TypeScript.
- [Agent sandboxes](/docs/using-the-app/ai-agent/sandboxes): what agents can do in the environment.
- [Configuration & Context](/docs/developer-tools/cli/configuration): active platform context.

---
_Markdown source of https://trickest.com/docs/developer-tools/cli/sandbox._