← All terms

Workspace Snapshot

An automatic, restorable capture of an agent's workspace, taken after every completed task.

Definition

A workspace snapshot is a capture of an agent's workspace taken at a point in time, automatically created after every task the agent completes. Snapshots form a timeline of restore points for that agent's workspace, and restoring one is non-destructive: it does not require discarding the agent's current state to go back to an earlier one.

How it works in Agenhood

After each task finishes, Agenhood snapshots the state of the agent's workspace volume without any action required from the user. Over time this builds a timeline that a user can browse from the web console, letting them see how the workspace evolved task by task and roll back to an earlier point if a later task produced an unwanted result. Because rollback is non-destructive, restoring an earlier snapshot does not permanently discard the states in between; the timeline is preserved rather than truncated. In addition to the built-in snapshot timeline, a workspace can be configured with an optional Git backup remote, using an SSH deploy key, so that changes are also pushed to an external Git repository on task completion.

Why it matters

Long-lived agents accumulate many tasks, and any one of them can leave the workspace in a state the user did not want: a bad edit, a failed generation, a destructive command. Automatic, per-task snapshots mean that recovery does not depend on the user remembering to save state before letting an agent run; every completed task is already a restore point. This matters more for agent workloads than for typical version control, since an agent operates autonomously between snapshots and a user may not review every intermediate change.

Related concepts

Taking automatic, event-triggered snapshots of persistent storage, and allowing non-destructive rollback to any of them, is a well-established pattern in storage systems, filesystems, and backup tooling generally. Agenhood applies the same idea at the granularity of a single agent task. Workspace snapshots are closely related to, but distinct from, the optional Git backup remote: snapshots are Agenhood's own restore-point mechanism, while the Git remote is an external, user-owned copy of the same workspace history.

Get started

Deploy your fleet.

Put a fleet of sandboxed agents to work on your own infrastructure, provisioned in seconds and watched live from one console.

Get started

Admin-provisioned · Self-host in one command · Your data never leaves your VM