A way back, when you need it.
Use receipts and backups to inspect and recover destination files.
Create a backup
In Saved Agents, open an agent and choose Back up. Portlift snapshots the adapter-recognized native files at its known locations. Check the resulting file list: unavailable locations and excluded files are not a full-project backup.
Migration backups are automatic for destination files the plan creates or updates. To keep the whole library, close Portlift and copy the actual library directory to protected storage.
Restore destination files
- Open Activity and select the migration receipt, or open Backups on a saved agent.
- Choose Preview restore. Inspect the files it will restore, remove, or skip.
- Choose Restore files. The current state is saved in a safety backup before restoration.
If a file changed after the preview, refresh it before approving. Restoring an existing file replaces its current contents with the backup, including later edits. A newly created file is deleted only if it still matches Portlift’s recorded write; otherwise it is skipped. Review every diff and skipped item.
Restore a saved version
In Saved Agents, select the desired version, compare it with the current version, then preview and confirm the restore. This changes the current library version. To put it into a runtime, use that version as a new migration source.
Recover after an update
New libraries are stored in ~/.portlift. If you already have an Agent Studio library in ~/.agent-studio, Portlift reuses it. Set PORTLIFT_DATA_DIR to choose a library explicitly. Close the app before making a copy of that directory. Install the previous release if you need to revert the CLI, then reopen the same library.