> For the complete documentation index, see [llms.txt](https://docs.orkestra.online/okpy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.orkestra.online/okpy/okpy-integrations/okpy-for-revit/build-with-the-agent/recovery-tool-backups.md).

# Recovery: Tool Backups

OkPy takes a recovery snapshot of a tool before each run, so a crash or an unwanted change never costs you the work.

## When snapshots are taken

A recovery snapshot is taken before each run. OkPy keeps up to five snapshots per tool and replaces the oldest when another snapshot is needed. The snapshots are stored on this computer, not in the cloud.

The list shows tools backed up in the last seven days. Select **Load older** to see the remaining tools and their snapshots. Use the tool list to choose which tool you want to recover, then choose one of that tool's snapshots.

## Restore a snapshot

Open **Tool Backups** from the Home screen to recover a tool. Choose the snapshot you want to open, then save the restored copy to keep it.

![The OkPy Home screen with Tool Backups available.](https://33703650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD6LqeGx95FZ5EJU6oorG%2Fuploads%2Fkd8VBS7Jiyo9K1ZN5dcM%2Fbackups-01-home.png?alt=media)

1. On the Home screen, select **Tool Backups**.
2. Select the tool.
3. Select its snapshot. **Latest** marks the most recent one.

![Door Summary selected in Tool Backups with its Latest snapshot.](https://33703650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD6LqeGx95FZ5EJU6oorG%2Fuploads%2FgaeKxRTUIahhFcWkxKI7%2Fbackups-02-window.png?alt=media)

4. Select **Open in editor**. The snapshot opens as a copy.

![The Door Summary snapshot opened as a separate copy in the editor.](https://33703650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD6LqeGx95FZ5EJU6oorG%2Fuploads%2FmbJ9wh9Pq7sonzOy3glV%2Fbackups-03-restored.png?alt=media)

5. Select **File > Save As** to keep the copy.

{% hint style="info" %}
Restoring never overwrites the current tool. The copy is a separate file until you save it over the original yourself.
{% endhint %}

For saving a restored tool, see **Local files: .okpy, Save, Save As**. For the related build workflow, see **How the agent builds a tool**.

## Housekeeping

Select **Reveal in Explorer** to open the folder that holds a tool's snapshots. This gives you access to the snapshots stored on this computer.

Use **Delete** to remove one snapshot. Use **Delete all** to remove every snapshot of a tool. Both actions ask for confirmation and cannot be undone. Check whether you selected one snapshot or all of the tool's snapshots before confirming.

If you only want to inspect the confirmation dialog, select **Cancel** to leave the snapshot in place.

![The confirmation for deleting one snapshot, with Delete and Cancel.](https://33703650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD6LqeGx95FZ5EJU6oorG%2Fuploads%2Fib53PWbPJVZ947LcxoqP%2Fbackups-04-delete-confirm.png?alt=media)