Mem archives

A .mem archive is a portable snapshot of project memory you can copy, backup, or move between machines. Export writes the archive; import restores observations into the local daemon store.

When to use it

• Back up before wiping ~/.statefulmemory/
• Share a project memory pack with a teammate (mind secrets in notes)
• Encrypt an archive with a seed file / phrase for transit

Export

statefulmemory mem export --out backup.mem
statefulmemory mem export --out secret.mem --seed-file ./phrase.txt
statefulmemory mem export --out secret.mem --seed-phrase 'your phrase here'

Import

statefulmemory mem import backup.mem
statefulmemory mem import secret.mem --seed-file ./phrase.txt

Use the same seed that was used at export for encrypted archives.

How it fits

Archives cover stored observations for the current project resolution — not your agent MCP configs. Day-to-day editing still uses observations and verify.

Troubleshooting

Symptom	Fix
Import decrypt error	Wrong --seed-file / phrase
Empty archive	Confirm project (STATEFULMEMORY_PROJECT / git root) before export
Huge file	Normal for long histories; prune with soft-delete before export if needed