mayros teleport

Export and import complete sessions between devices. Bundles include the conversation transcript, session store, Cortex triples, and optionally project memory into a portable JSON file.

Global options

  • --cortex-host <host> — Cortex host
  • --cortex-port <port> — Cortex port
  • --cortex-token <token> — Cortex auth token

Subcommands

teleport export

Export a session as a portable JSON bundle. The bundle includes the conversation transcript (base64-encoded), session store, and Cortex triples associated with the session.

OptionDescription
-s, --session <key>Session key to export (required)
-o, --output <file>Output file (default: teleport-<session>.json)
--project-memoryInclude project memory triples in the bundle

teleport import <file>

Import a session from a teleport bundle file. Restores the transcript, session store, and Cortex triples on the target device.

OptionDescription
--remap <key>Remap to a different session key on import

teleport inspect <file>

Inspect the contents of a teleport bundle without importing it. Shows metadata including version, export date, source device, session key, transcript size, store fields, and triple counts.

OptionDescription
--format <fmt>Output format: terminal (default) or json

Examples

bash
mayros teleport export --session my-session
mayros teleport export -s my-session -o backup.json --project-memory
mayros teleport import backup.json
mayros teleport import backup.json --remap new-session-key
mayros teleport inspect backup.json
mayros teleport inspect backup.json --format json