Skip to content

systemslab workspace create ​

Description Create a new workspace.
Usage systemslab workspace create [OPTIONS] --name <NAME> <SLUG>

Description ​

The systemslab workspace create command creates a workspace: a named, shareable collection of contexts and notebooks. It prints the URL of the new workspace's page, or just its slug with --output-format short.

sh
systemslab workspace create allocator-sweep --name "Allocator sweep" \
    --description "Comparing jemalloc and mimalloc"

The slug is the workspace's handle in URLs and in other systemslab workspace commands. It must be 1 to 64 lowercase letters, digits and -, start with a letter or digit, and not already be used by a workspace that hasn't been archived. It also can't look like a UUID, since workspaces can be given by id wherever a slug is accepted.

Options ​

OptionDefaultDescription
<SLUG>The workspace's slug, e.g. allocator-sweep.
--name <NAME>A human-readable name for the workspace. Required.
--description <DESCRIPTION>A markdown description of what the workspace is for.
--readme <NOTEBOOK-ID>A notebook that introduces the workspace.

Common Options ​

OptionDefaultDescription
--systemslab-url The URL at which to access the systemslab server.
--colorauto Controls when color is used in the output. Possible values are auto, always, and never.
--output-formatlong Output format to use when outputting messages. long will result output designed to be human-readable while short is short output meant to be used within scripts.

Environment Variables ​

VariableDescription
SYSTEMSLAB_URLSpecify the URL used to contact the SystemsLab server. Equivalent to --systemslab-url.