agentbox 命令

常用示例

说明

agentbox is the command-line client for AgentBox.cloud, a managed service that runs AI agents inside isolated x86 and Android cloud sandboxes. The CLI mirrors the capabilities of the AgentBox web dashboard: it authenticates the developer, lists and terminates running sandboxes, and manages the custom template images that define how sandboxes are provisioned. The CLI is typically used alongside the AgentBox Python and JavaScript SDKs. SDKs spawn sandboxes programmatically from application code; the CLI is the administrative companion for auditing, clean-up, and authoring reusable sandbox templates without leaving the terminal. agentbox template create produces a directory containing a template manifest and a Dockerfile-like recipe. agentbox template build packages that directory into an image that subsequent SDK calls can reference by name, giving agent code a consistent, reproducible starting environment.

参数

auth login

Authenticate the CLI against AgentBox cloud and persist credentials locally.

auth logout

Remove stored credentials from the local machine.

sandbox list

List sandboxes visible to the authenticated account.

sandbox kill _id_

Terminate the sandbox with the given _id_. Data inside the sandbox is discarded.

sandbox kill --all

Terminate every sandbox the account currently has running.

template create _name_

Scaffold a new custom sandbox template in the current directory.

template build

Build the template defined in the current directory into a deployable image.

--state _states_

Filter sandbox list to comma-separated states (running, paused).

--metadata _key=value,..._

Filter sandbox list by metadata key/value pairs.

--limit _N_

Limit sandbox list results to _N_ entries (default 10).