Multi-device sync

eden-memory can keep the same memory store in sync across multiple devices. Sync is peer-to-peer: devices exchange signed delta logs, and conflicts are resolved with logical clocks. You can sync two databases on the same host, or sync across different hosts through a lightweight relay.

Start here

New to multi-device sync? Read the step-by-step tutorial:

• Sync two devices with a relay (tutorial)

Sync modes

Mode	Use case	Pairing	Best for
Direct sync	Two databases on the same machine or shared filesystem	Optional pair-device	One-shot local backup or shared store
Relay sync loop	Devices on different networks	Required	Continuous sync across laptops, desktops, or servers

Where the details live

Tutorials

• Sync two devices with a relay — full relay sync from install to verified loop.
• Sync two databases locally — direct one-shot sync on the same machine.
• Connect your MCP client — first-time client wiring for Claude Code, Cursor, Hermes, or any stdio MCP client.

How-to guides

• Run your own relay server — stand up and secure a self-hosted relay.
• Deploy on a public VPS — full public-internet relay walkthrough with Let’s Encrypt, systemd, and hardening.
• Approve a peer key rotation — inspect and approve pending Ed25519/X25519 key changes.
• Back up and restore a database — encrypted snapshots and sidecar backup strategy.
• Prune old memories — scoped bulk deletion.

Concepts

• How sync works — delta logs, logical clocks, conflict resolution, double envelope, PAKE pairing, and key rotation.
• Sidecar files — <db>.sync-keys.json and <db>.root-key.json.
• Security model — relay threat model, password requirements, and what the relay can and cannot see.

Reference

• CLI reference — sync, pairing, relay, and global flags.
• Tools reference — MCP tool schemas for sync and pairing.
• Environment variables — env vars and cascading precedence.
• Troubleshooting — symptom → cause → fix matrix.

Sync in one command

Direct sync between two local databases:

eden-memory --db ~/.eden-memory/local.db \
  sync --peer-db /mnt/shared/peer.db --confirm

Start a foreground relay sync loop:

eden-memory --db ~/.eden-memory/device.db \
  sync loop start \
  --relay-url http://relay.example.com:8787 \
  --account-id your-account \
  --root-key-passphrase "$(cat passphrase.txt)" \
  --confirm

See the CLI reference for every flag and subcommand.