Checkpoints let you restore an earlier filesystem state of your Hand’s machine. They are useful after changes to files or installed software that you need to undo. A checkpoint is not a backup of external accounts, provider permissions or approvals.
Find checkpoints
- Open the Hands Console and select the intended Hand.
- Go to My Hand → Checkpoints.
- Allow the saved checkpoints to load. The information icon explains their purpose.
A ready Hand and the required account/subscription access are necessary. If the list cannot be read, the Console reports an error; do not mistake that for an empty checkpoint history.
Create a checkpoint
- Open My Hand → Checkpoints before making substantial changes to files or the workspace.
- Select New checkpoint.
- Wait for the success message confirming that the checkpoint was created.
- Verify that the checkpoint appears in the saved list. Only then proceed with changes you may want to undo.
Creation can fail if the Hand is unavailable, unhealthy or busy with another operation. If the result is uncertain, refresh the history and check whether the checkpoint exists before clicking again.
Restore an earlier checkpoint
- Find an existing, healthy checkpoint made before the unwanted changes.
- Select Restore beside that entry.
- Read the warning: files written since that checkpoint will be lost if you restore it.
- Confirm only if you want to roll the machine back to that earlier filesystem state. The Console reports progress and refreshes its data on completion.
- Verify your most important files, workspace and Hand behavior after the restore.
Restoring rolls machine files back. Software, settings and local configuration files written after the checkpoint may therefore disappear or change. A provider’s successful restore response does not prove that every application or connected service is healthy.
What a restore does not automatically recover
A checkpoint does not automatically restore external OAuth grants, provider access, integration permissions, approvals or provider connections. A credential that once worked may also have expired or been revoked outside the Hand. Check those connections separately and reauthorize as necessary.
You can remove a saved checkpoint using its trash icon and confirming deletion. That removes the recovery point itself, so it cannot be used later. Keep important copies of valuable files separately: checkpoints are not a guaranteed long-term archive or individual file version history.
Related guides
Manage Files in the workspace · Store credentials safely in Vault · Set up My Hand and manage access