Skip to content
Everruns Cloud is open in early access. Run agents without operating the platform.

Sandboxes across providers: state, history, usage.

CommandWhat it does
sandboxes getGet one Sandbox with its provider resources and full state history.
sandboxes listList the organization’s Sandboxes across providers: running, paused, lost and deleted, with filters.
sandboxes stats getSummarize the organization’s Sandboxes: counts by state and provider, recent creations, running time, recoveries and how many need attention.
sandboxes timeline getShow when each Sandbox was running, paused or lost over a time window, with how many ran at once.

Get one Sandbox with its provider resources and full state history.

Terminal window
everruns sandboxes get [OPTIONS] [ID]
FlagDescription
--id <ID>Logical Sandbox id.

Example:

Terminal window
# See why a Sandbox was rebuilt
everruns sandboxes get sandbox_01h9

List the organization’s Sandboxes across providers: running, paused, lost and deleted, with filters.

Terminal window
everruns sandboxes list [OPTIONS]
FlagDescription
--agent-id <AGENT_ID>Only Sandboxes of Sessions that ran this Agent.
--include-in-processInclude in-process targets (virtual filesystem, host), which have no provider resource.
--limit <LIMIT>Page size, 1 to 200.
--needs-attentionOnly Sandboxes with at least one attention reason.
--offset <OFFSET>Rows to skip.
--provider <PROVIDER>Comma-separated provider ids, such as daytona,modal.
--sandbox-template-id <SANDBOX_TEMPLATE_ID>Only Sandboxes created from this Sandbox Template.
--search <SEARCH>Case-insensitive match on Session title, Agent, provider or provider resource id.
--state <STATE>Comma-separated states: running, paused, lost, starting, failed, not_started, `de…

Example:

Terminal window
# Find Sandboxes that need attention
everruns sandboxes list --needs-attention true

Summarize the organization’s Sandboxes: counts by state and provider, recent creations, running time, recoveries and how many need attention.

Terminal window
everruns sandboxes stats get [OPTIONS]
FlagDescription
--agent-id <AGENT_ID>Only Sandboxes of Sessions that ran this Agent.
--include-in-processInclude in-process targets (virtual filesystem, host), which have no provider resource.
--needs-attentionOnly Sandboxes with at least one attention reason.
--provider <PROVIDER>Comma-separated provider ids, such as daytona,modal.
--sandbox-template-id <SANDBOX_TEMPLATE_ID>Only Sandboxes created from this Sandbox Template.
--search <SEARCH>Case-insensitive match on Session title, Agent, provider or provider resource id.
--state <STATE>Comma-separated states: running, paused, lost, starting, failed, not_started, `de…

Example:

Terminal window
# See how many Sandboxes are running and how many need attention
everruns sandboxes stats get --provider daytona

Show when each Sandbox was running, paused or lost over a time window, with how many ran at once.

Terminal window
everruns sandboxes timeline get [OPTIONS]
FlagDescription
--agent-id <AGENT_ID>Only Sandboxes of Sessions that ran this Agent.
--from <FROM>Window start (RFC 3339).
--include-in-processInclude in-process targets (virtual filesystem, host), which have no provider resource.
--limit <LIMIT>Lanes to return, 1 to 200.
--needs-attentionOnly Sandboxes with at least one attention reason.
--provider <PROVIDER>Comma-separated provider ids, such as daytona,modal.
--sandbox-template-id <SANDBOX_TEMPLATE_ID>Only Sandboxes created from this Sandbox Template.
--search <SEARCH>Case-insensitive match on Session title, Agent, provider or provider resource id.
--state <STATE>Comma-separated states: running, paused, lost, starting, failed, not_started, `de…
--to <TO>Window end (RFC 3339).

Example:

Terminal window
# See when Sandboxes ran or were lost over the last day
everruns sandboxes timeline get --from 2026-05-01T00:00:00Z --to 2026-05-02T00:00:00Z --state running,lost