> ## Documentation Index
> Fetch the complete documentation index at: https://docs.idyl.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspaces

> Durable logical computers for files, Runs, and retained working context.

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:

```text theme={null}
Account → Namespace → Workspace
```

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

```bash theme={null}
idyl use <namespace>/<workspace>
```

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

## Related guides

* [Work in a Workspace](/build/work-in-a-workspace)
* [Workspace resource](/resources/workspaces)
* [Namespaces](/concepts/namespaces)