Versions and recovery

Versions record the state of the whole Space, including its .eidos files and ordinary files. Save a version after completing a meaningful set of changes, such as “Organized customer records” or “Before publishing.”

Versions stay local and do not require an account.

Turn on Versions

1. Open a Space.
2. Select the Versions button—the clock icon—in the top-right corner.
3. Select Enable versioning.

Eidos Lite saves the current Space as its first version. The next time you open the panel, it shows Changes and History.

Exclude files from Versions

Add a .gitignore or .graftignore file to the Space when generated files, caches, secrets, or other local-only content should stay out of version management. Eidos Lite reads these files from the Space root and from nested directories. Matching files that are not already tracked do not appear under Changes and are not added to new Versions.

Both files use Git’s ignore-pattern syntax. Use .gitignore when the rules should also apply to Git, or .graftignore for Eidos Lite’s version management only. When both files in the same directory match a path, the .graftignore rule takes precedence; rules in deeper directories take precedence over rules inherited from parent directories.

For example:

node_modules/
*.tmp
private/

Ignore rules do not delete local files. A path that was already tracked before a matching rule was added remains under version management, and its existing history is preserved.

Save a version

1. Finish a group of edits, then open Versions.
2. Review the changed files under Changes.
3. Add an optional Version note, such as “Added August invoices.”
4. Select Save version.

The saved version now appears under History.

Tip

To let Eidos Lite save a version after local activity settles, turn on Settings → Spaces → Automatic versions.

Review an earlier change

1. Open Versions and switch to History.
2. Select a version to see which files changed.
3. Select a file to inspect supported text or table differences.

Reviewing History does not change the current files.

Restore an earlier version

Restoring returns the whole Space to the selected version, not only the file currently open.

1. Check Changes for unsaved work. If there is any, save it as a version first.
2. Open History and select the version you want.
3. Select Restore this version.
4. Confirm with Restore Space.

Eidos Lite saves another version to record the restore. You can still return to the state from before the restore.

Versions are not backups

Version history lives on the same computer as the Space. A lost device or failed drive can affect both. Back up the whole Space as described in Data, attachments, and backups.