Skip to main content
A mount path is ephemeral. Snapshots are the durable state behind it. Workspaces keep that snapshot history, so you can reattach after unmounts and sandbox restarts. Use these commands to inspect a workspace, reattach it, delete it, diff it, or restore an earlier snapshot.

Check Status

With unsnapshotted changes, status lists dirty paths:
Add --json for machine-readable output.

List Workspaces

Reattach a Workspace

Unmounting keeps the workspace by default:
Reattach it later from the same sandbox, another sandbox, or another machine. The new mount path can be different:
A workspace already mounted elsewhere defaults to read-only if you mount it again. Pass --mode rw to force it writable.

Delete a Workspace

Or delete it while unmounting:

Diff

Diff the mount against its last snapshot:
Diff any two snapshots or commits:

Restore

Restore the mount contents to an earlier snapshot:
Restore does not rewrite history. It changes the working directory, and the next snapshot records the restored state.