Skip to main content
A sandbox is a live set of tools with starter data, for exploring by hand or pointing an agent at outside a test. Sandboxes have no task and no checks; they are never graded. Start a server first with ancha serve. Every subcommand takes --json.

​
ancha sandbox presets

Output

​
ancha sandbox datasets

Output

​
ancha sandbox configuration

Prints a portable configuration without starting anything. With --json, save it to a file, edit the datasets, and start a sandbox from it:

​
ancha sandbox create

Output
Choose tools with --tools slack,github, a --preset, or a --definition file. The lease defaults to one hour.

​
ancha sandbox connections

Prints the variables your agent needs, one NAME=value per line, ready to export:
Output

​
ancha sandbox inspect

Prints the current records as tables, for example Slack’s channels and messages. Use it to see what your agent changed.

​
ancha sandbox activity

Output
Each line is a sequence number, tool, method, path and status. Pass --after <n> to read only newer calls.

​
ancha sandbox advance

Output
Moves the sandbox’s simulated clock forward, for data that becomes available over time, such as a delayed Gong transcript or a pending ad review. It does not deliver ads or create new reporting data.

​
ancha sandbox fork

Creates up to 20 fresh copies of the sandbox’s original data, without the changes made since. Forking starts no agent.

​
ancha sandbox reset

Output
Restores the tools’ starter data and IDs. Your agent’s own files and memory are not reset.

​
ancha sandbox show, list and delete

show --json returns the exact active configuration and its fingerprint. Sandboxes also end when the server stops.