CLI Reference

create

Create resources.

Create Collection

dreamlake create collection <name> --project space[@namespace] [--episode <glob>] [--description <desc>] [--tags <tags>]

Flag	Type	Required	Description
`<name>`	positional	Yes	Collection name (unique within space)
`--project`	string	Yes	Target: `space[@namespace]`
`--episode`	string	No	Glob pattern to match episodes by node path
`--description`	string	No	Description text
`--tags`	string	No	Comma-separated tags

When --episode is provided, all episodes matching the glob are added as members. The CLI shows matched episodes and asks for confirmation before creating.

Examples

# Empty collection
dreamlake create collection "front-camera" --project robotics@alice
 
# With episodes via glob
dreamlake create collection "april-runs" --project robotics@alice --episode "2026/04/*"
 
# With metadata
dreamlake create collection "training-set" --project robotics \
  --description "Q1 training data" --tags robotics,training
 
# Glob against node hierarchy
dreamlake create collection "all-cameras" --project robotics@alice --episode "camera/front/*"

Episode Glob

The --episode pattern matches against the episode's full node path in the hierarchy. For example, if episodes are organized as:

/2026/04/run-001
/2026/04/run-002
/2026/03/run-001
/camera/front/session-1

Then "2026/04/*" matches the first two, and "camera/*/*" matches the last one.

Errors

Error	Cause
`collection already exists`	Name is taken in this project
`project not found`	Space or namespace doesn't exist
`no episodes match`	Glob pattern didn't match any episodes

Create Dataset

dreamlake create dataset <name> --project space[@namespace] [--description <desc>] [--tags <tags>]

Flag	Type	Required	Description
`<name>`	positional	Yes	Dataset name (unique within space)
`--project`	string	Yes	Target: `space[@namespace]`
`--description`	string	No	Description text
`--tags`	string	No	Comma-separated tags

Examples

dreamlake create dataset "training-v1" --project robotics@alice
dreamlake create dataset "training-v1" --project robotics@alice \
  --description "Q1 training" --tags robotics,training

Use dreamlake update dataset --add to add collections to the dataset after creation.