Skip to main content
A Workspace is a durable logical computer inside one Namespace. It retains files, configuration, Run history, and artifacts independently of active Workloads. The resource hierarchy is:
Workspace names are unique within their Namespace. Address a Workspace as <namespace>/<workspace>.

​
Workspace files

Workspace files are small durable files stored at relative paths. Listing a Workspace returns file metadata; reading one file returns its bytes. A Run captures an immutable input revision of the current file set.

​
Workspace Runs

A Run records durable execution intent and attempt history. IDYL creates the authoritative Workload for each attempt in the enclosing Namespace. Stopping or resuming a Run changes its attempt history without changing its captured input revision. Direct Workloads remain Namespace-scoped and do not require a Workspace.

​
Enter a Workspace

Use idyl use <namespace> to return to Namespace scope.