Skip to main content
Workspaces survive unmounts and sandbox restarts. Use these commands to inspect a workspace, reattach it, delete it, diff it, or restore an earlier snapshot.

​
Check Status

$ tl fs status /work
file system: agent-outputs
workspace: 3f9a2b7e1c4d (created 12m ago)
daemon: mounted at 8b21f6a9c3d5e7f1a2b4c6d8e0f3a5b7c9d1e3f5
local: clean
With unsnapshotted changes, status lists dirty paths: 
local: 2 change(s):
  M src/parser.py
  D src/old_parser.py
Add --json for machine-readable output.

​
List Workspaces

$ tl fs ls
Workspace      File system      Base   Snapshots   Mode        Mounted   Age
3f9a2b7e1c4d   agent-outputs    main   2           workspace   yes       12m

Mount: tl fs mount <workspace> <path>
Delete: tl fs rm <workspace>

​
Reattach a Workspace

Unmounting keeps the workspace by default: 
$ tl fs unmount /work
Unmounted /work. Workspace 3f9a2b7e1c4d kept. Mount it again with: tl fs mount 3f9a2b7e1c4d /work
Reattach it later from the same sandbox, another sandbox, or another machine: 
$ tl fs mount 3f9a2b7e1c4d /work2
Mounted workspace 3f9a2b7e1c4d (agent-outputs) at /work2, resumed at its last snapshot
A workspace already mounted elsewhere defaults to read-only if you mount it again. Pass --mode rw to force it writable.

​
Delete a Workspace

$ tl fs rm 3f9a2b7e1c4d
Deleted workspace 3f9a2b7e1c4d (file system agent-outputs).
Or delete it while unmounting: 
$ tl fs unmount /work --delete
Unmounted /work (workspace 3f9a2b7e1c4d deleted).

​
Diff

Diff the mount against its last snapshot: 
tl fs diff /work
Diff any two snapshots or commits: 
tl fs diff /work 4a1f9c2d8b3e 8b21f6a9c3d5

​
Restore

Restore the mount contents to an earlier snapshot: 
$ tl fs restore /work 8b21f6a9c3d5e7f1a2b4c6d8e0f3a5b7c9d1e3f5
Restored /work to 8b21f6a9c3d5 (12 file(s) refreshed, 1 removed).
Restore does not rewrite history. It changes the working directory, and the next snapshot records the restored state.