CLI Reference

update

Update resources. Supports adding/removing members via glob patterns and updating metadata.

Update Collection

Add/Remove Episodes

dreamlake update collection <name> --project space[@namespace] --add <glob>
dreamlake update collection <name> --project space[@namespace] --remove <glob>

Flag	Type	Required	Description
`<name>`	positional	Yes	Collection name
`--project`	string	Yes	Target: `space[@namespace]`
`--add`	string	No	Glob pattern to match episodes by node path
`--remove`	string	No	Glob pattern to match episodes by node path
`--description`	string	No	Update description
`--tags`	string	No	Update tags (comma-separated)

The --add and --remove flags match episodes by their full node path in the hierarchy. Both can be used in the same command.

# Add all April episodes
dreamlake update collection "my-set" --project robotics@alice --add "2026/04/*"
 
# Remove a specific episode
dreamlake update collection "my-set" --project robotics@alice --remove "2026/04/run-001"
 
# Add and remove in one call
dreamlake update collection "my-set" --project robotics@alice \
  --add "camera/*" --remove "camera/back/*"
 
# Update metadata only
dreamlake update collection "my-set" --project robotics@alice \
  --description "Updated description" --tags "v2,final"

Update Dataset

Add/Remove Collections

dreamlake update dataset <name> --project space[@namespace] --add <glob>
dreamlake update dataset <name> --project space[@namespace] --remove <glob>

Flag	Type	Required	Description
`<name>`	positional	Yes	Dataset name
`--project`	string	Yes	Target: `space[@namespace]`
`--add`	string	No	Glob pattern to match collections by name
`--remove`	string	No	Glob pattern to match collections by name
`--description`	string	No	Update description
`--tags`	string	No	Update tags (comma-separated)

For datasets, --add/--remove match collection names (not episode paths).

# Add all front-camera collections
dreamlake update dataset "training-v1" --project robotics@alice --add "front-*"
 
# Remove old collections
dreamlake update dataset "training-v1" --project robotics@alice --remove "old-*"
 
# Update metadata
dreamlake update dataset "training-v1" --project robotics@alice --tags "v2,production"

Glob Patterns

Pattern	Matches
`*`	All items
`run-*`	`run-001`, `run-002`, etc.
`2026/04/*`	All items under `2026/04/` path
`camera//session-`	e.g. `camera/front/session-1`

Errors

Error	Cause
`no episodes match` / `no collections match`	Glob didn't match anything
`collection not found` / `dataset not found`	Resource doesn't exist
`nothing to update`	No flags provided