Skip to content
Wayland Docs

Import from Another Agent CLI

If you are arriving from another agent CLI, migrate brings your history with you.

Terminal window
wayland-core migrate

Importers landed in v0.12.26 for openclaw, grok, and gemini-cli.

Discovery is typed, redacted, and deterministic

Section titled “Discovery is typed, redacted, and deterministic”

Three properties, each doing real work:

  • Typed. Discovery knows what shape it is looking at rather than guessing from a file extension.
  • Redacted. Secrets found during discovery are redacted rather than carried into your new state.
  • Deterministic. The same source produces the same discovery result, so a second run is comparable to the first.

Provenance is bound to where the bytes landed

Section titled “Provenance is bound to where the bytes landed”

Every provenance record is bound to where the bytes actually landed, not to where the importer intended to put them. If the two ever disagree, the record follows reality.

For the same reason, imported content is genuinely written before it is counted, and only what was written is counted. An import summary reporting 400 conversations means 400 conversations exist, not 400 conversations were attempted.

Quarantine

Section titled “Quarantine”

Content that cannot be imported cleanly goes to quarantine rather than being dropped or forced through. The quarantine index is written atomically, so an interrupted import does not leave a quarantine index that disagrees with the quarantine itself.

The containment contract was measured at real import scale rather than sampled.

If an import goes wrong

Section titled “If an import goes wrong”

migrate is rollback-able through the scoped operation journal. See Backup, Restore, and Rollback.

Taking a backup before a large import is still the cheaper habit.