View Sandbox Status

Use these commands to inspect registered sandboxes and collect evidence before changing a sandbox.

Use this guide after you finish Quickstart with Deep Agents.

List Sandboxes

List every sandbox registered on this host:

$
nemo-deepagents list

The list shows each sandbox’s model, provider, policy presets, and active SSH session indicator. Use JSON output for scripts:

$
nemo-deepagents list --json

Check Sandbox Health

Check a specific sandbox’s health, inference route, active connections, live policy, and update status:

$
nemo-deepagents my-assistant status

Use the host-level status command when you want the sandbox inventory plus host auxiliary service state, such as cloudflared:

$
nemo-deepagents status

Inspect Logs

View recent sandbox logs:

$
nemo-deepagents my-assistant logs

Stream logs while you reproduce a problem:

$
nemo-deepagents my-assistant logs --follow

The log command reads Deep Agents sandbox output and OpenShell audit events, so policy denials appear beside terminal-runtime logs.

Collect Diagnostics

Collect diagnostics for bug reports or support handoff:

$
nemo-deepagents debug --sandbox my-assistant --output nemoclaw-debug.tar.gz

Use --quick for a smaller local summary:

$
nemo-deepagents debug --quick --sandbox my-assistant

The debug command gathers system information, Docker state, sandbox logs, and sandbox status.

Related Topics

• Run Sandboxes for multiple-sandbox naming and start or stop operations.
• Recover and Rebuild Sandboxes when status or logs show that a runtime needs repair.
• Troubleshooting for symptom-based remediation.
• CLI Selection Guide for the boundary between nemo-deepagents and lower-level OpenShell commands.