Backup and Rollback

The default push path is conservative. It creates a rollback-capable workbook backup before replacing VBA components.

xlflow push --json

Backups are stored under .xlflow/backups/<backup-id>/ and include both the copied workbook file and metadata.json.

List available rollback targets with:

xlflow backup list --json

Restore the newest backup with:

xlflow rollback --latest --json

Or restore a specific backup ID:

xlflow rollback --backup 20260518-175330-push --json

Rollback restores only the workbook file. If source files should match the restored workbook, run:

xlflow pull --json

Fast development loops may use:

xlflow push --fast --session --no-save --json

That skips workbook backup creation for speed and leaves the live session dirty until xlflow save --session.

If an xlflow session is active for the workbook, rollback fails safely instead of replacing the file underneath the live workbook. Stop the session first:

xlflow session stop --json

For review, use diff to compare workbook files and optional exported VBA trees:

xlflow diff before.xlsm after.xlsm --vba-before before-src --vba-after after-src --json