docs/cli/backup.mdx
CowAgent can create a portable local archive for migration or disaster recovery.
cow backup
cow backup --output /safe/location/cow-backup.zip
The archive contains:
config.jsonAGENT.md, USER.md, and MEMORY.mduser_datas.pkl, when presentTransient tmp/ data, caches, Git metadata, and symbolic links are skipped. The
archive is written with owner-only permissions where the operating system
supports them.
Stop CowAgent before restoring:
cow stop
cow restore /safe/location/cow-backup.zip
Use --workspace to migrate workspace files to a different location:
cow restore cow-backup.zip --workspace ~/cow-restored
Restore validates the archive format and paths before writing anything. It
overwrites matching files but does not delete unrelated files already present
at the destination. When current CowAgent data exists, the command first
creates a cow-pre-restore-*.zip rollback archive beside the selected backup.
For unattended scripts, pass --yes to acknowledge overwrites.