Expand description
oxicode migrate subcommand family.
Routes every migrate-style subcommand to the matching handler. The
only handler currently shipping is migrate_brain, which migrates
legacy durable memory (the SQLite / Mnemopi / summary backends) to
the Foundation v1 host’s only durable-memory authority: the
oxibrain daemon.
The migration is resumable: a checkpoint under
~/.oxicode/migration/brain.json records the last successfully
migrated memory ID. Restarting the migration resumes from the
checkpoint; clearing the file restarts from scratch.
The migration is non-destructive: the legacy store is left
intact until the user explicitly archives it with
oxicode migrate brain --archive-legacy. Archival moves the
legacy store out of the active path to
~/.oxicode/archive/memory/<timestamp>/. The legacy store cannot
be re-enabled silently.
§Reference
docs/superpowers/specs/2026-08-17-oxi-foundation-contract.md §
“Migration”.
Functions§
- handle_
migrate - Top-level dispatcher. Returns the exit code.