sim sandboxes is also spelled sim sandbox.
Every command below also accepts the global options.
Create sandbox
sim sandboxes create [options]Create Sandbox (personal API key required)
Options
| Option | Required | Description |
|---|---|---|
--name <value> | Yes | Display name, unique within the workspace; 1 to 64 characters. |
--language <value> | Yes | Dependency ecosystem: javascript installs from npm, python from PyPI. Accepted values: javascript, python. |
--dependencies <value...> | No | Package specifiers installed into the sandbox, one per entry. (space-separated, or @path / @- with one value per line; in a file, blank lines and # comments are ignored, while inline values are sent as typed and may not be empty; @@value for a literal leading @). |
--cli-tools <value...> | No | Pinned managed CLI ids installed into the sandbox, at most 10, no duplicates. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). |
--system-packages <value...> | No | Debian packages installed into the sandbox, one per entry. (space-separated, or @path / @- with one value per line; in a file, blank lines and # comments are ignored, while inline values are sent as typed and may not be empty; @@value for a literal leading @). |
Delete sandbox
sim sandboxes delete <sandboxId> [options]Delete Sandbox (personal API key required)
Arguments
| Argument | Required | Description |
|---|---|---|
sandboxId | Yes | Unique sandbox identifier. |
Options
| Option | Required | Description |
|---|---|---|
-y, --yes | Yes | Confirm this operation. |
Get sandbox
sim sandboxes get <sandboxId>Arguments
| Argument | Required | Description |
|---|---|---|
sandboxId | Yes | Unique sandbox identifier. |
List sandboxes
sim sandboxes list [options]Options
| Option | Required | Description |
|---|---|---|
--search <value> | No | Case-insensitive substring match against the sandbox name. |
--sort-by <value> | No | Field used to sort the result. Sorting by name is case-sensitive and follows the storage collation, so do not rely on a case-insensitive order. Accepted values: name, createdAt, updatedAt. |
--sort-order <value> | No | Sort direction. Accepted values: asc, desc. |
--limit <n> | No | Maximum items to return (0 for everything). Defaults to 100. |
Update sandbox
sim sandboxes update <sandboxId> [options]Update Sandbox (personal API key required)
Arguments
| Argument | Required | Description |
|---|---|---|
sandboxId | Yes | Unique sandbox identifier. |
Options
| Option | Required | Description |
|---|---|---|
--name <value> | No | New display name, unique within the workspace; 1 to 64 characters. |
--language <value> | No | Replacement dependency ecosystem. The whole spec is revalidated against it, so a Python dependency list does not survive a switch to JavaScript. Accepted values: javascript, python. |
--dependencies <value...> | No | Replacement package list; replaces the whole list. (space-separated, or @path / @- with one value per line; in a file, blank lines and # comments are ignored, while inline values are sent as typed and may not be empty; @@value for a literal leading @). |
--cli-tools <value...> | No | Replacement managed CLI list; replaces the whole list. (space-separated, or @path / @- with one value per line; @@value for a literal leading @). |
--system-packages <value...> | No | Replacement Debian package list; replaces the whole list. (space-separated, or @path / @- with one value per line; in a file, blank lines and # comments are ignored, while inline values are sent as typed and may not be empty; @@value for a literal leading @). |