Workspace tools

Every thread runs in its own isolated workspace: a Debian 12 machine with your project checked out at /workspace/repo. Open the workspace dock beside the conversation (Mod Alt B) to see what the agent sees.

Files

Browse and read the workspace's files. Links to files in the agent's replies open here.

Changes

Review the diff of everything the agent changed, with Show files to list changed paths. A sleeping workspace asks you to wake it before it can read changes.

Terminal

A real terminal in the workspace, backed by tmux, so it survives closing the tab. Opening the Terminal tab or pressing Start creates a session; reopening attaches to the existing one. You can quote terminal text into the composer.

Preview

Open a web app running in the workspace on any application port from 1024 to 65535 (except 4096, 4500 and 9229, which the harness uses). The default port is 5173. Each preview gets its own address with a per-port token, on a domain separate from Statefold, so you can open it in a new tab or on your phone.

Opening a preview while the workspace sleeps shows a Wake workspace page first; waking starts billed machine time. An agent can publish an app with its expose_app tool, and that app restarts after the workspace wakes.

Sleep and wake

A workspace sleeps about ten minutes after the agent goes idle. Sleeping saves the workspace, including files the agent was still writing, and stops the machine, so it costs nothing. Sending a message or choosing Wake workspace in thread details brings it back as it was.

A thread waiting on your answer to a question stays awake. On Codex it sleeps after four hours unanswered.

Docker

Docker, Docker Compose and Buildx are installed in every workspace with the daemon off. The agent starts it when it needs it. Containers need host networking (--network=host, or network_mode: host in Compose). Docker is stopped before a save and started again after waking if it was running.

Preinstalled tools

Pinned versions change only with a Statefold release; the rest follow Debian 12.

To have dependencies and build output ready when a thread starts, save a project environment.