sbx create

Description

Create a sandbox with access to a host workspace for an agent.

The first positional argument may be a built-in agent name or a sandbox kit reference. Sandbox kit references may be local directories, ZIP files, git repositories, or OCI references. Relative local references must be explicit paths such as ./my-kit or ../my-kit.zip.

Omit the path to create a sandbox without a workspace bind mount: the agent then works in the container's own filesystem instead of on your files.

Use "sbx run --name SANDBOX" to attach to the agent after creation.

Without --cpus/--memory a cloud sandbox defaults to 2 CPUs and 4 GiB.

Commands

Options

Global options

Examples

# Create a sandbox for Claude in the current directory
sbx create claude .

# Create a sandbox with a custom name
sbx create --name my-project claude /path/to/project

# Create with additional read-only workspaces
sbx create claude . /path/to/docs:ro

# Create without a workspace bind mount
sbx create claude

# Create from a local sandbox kit
sbx create ../path/to/my-agent/

# Add a mixin to a built-in agent
sbx create claude --kit ./my-mixin/

# Run the agent on an in-container clone of the host repo, wired back via a git-daemon
sbx create --clone claude .