Memory Sync

Windows user guide

Use this guide when an administrator has given you a server URL and an invite code. The invite code is used only for initial registration. Never post it in chat, screenshots, or Markdown memory files.

Before you start

You need:

  1. A Windows PC with network access.
  2. Python 3.10 or newer. Select Add Python to PATH during installation.
  3. Your server URL, such as https://sync.example.com, and an invite code from the administrator.
  4. A folder containing only your personal Markdown memories, for example C:\Users\you\Documents\memory. Do not select company source code, chat exports, or a folder that contains passwords.

If PowerShell does not recognize py, install Python 3.11 first:

winget install -e --id Python.Python.3.11

If Winget reports a source 403 or download error, run these commands once and retry:

winget source reset --force
winget source update

If it still fails, download the 64-bit installer from the official Python Windows download page. Select Add Python to PATH, then open a new PowerShell window after installation.

Close the current PowerShell window, open a new one, then confirm:

py --version

First installation and registration

Download the Windows memory-sync Skill from the production service. Extract the memory-sync folder from the archive to either location:

  • Codex: %USERPROFILE%\.codex\skills\memory-sync
  • DSH: %USERPROFILE%\.dsh\skills\memory-sync

The Skill contains the client source and offline Windows dependencies for Python 3.10–3.14; it contains no project-specific EXE. It uses only an approved Python installation already present on the device. Normal operation connects only to sync.chuanpiao.ltd on Alibaba Cloud in Hangzhou and does not access GitHub or PyPI or require a VPN. If approved Python is unavailable, the device administrator must install or whitelist it; the Skill does not bypass application-control policy. Restart the Agent or open a new session, then ask it to use the memory-sync Skill to synchronize your memory.

Alternative: install with Python

  1. Open PowerShell and install the client directly from the production service. You do not need to download, extract, or delete an old ZIP. Run the same command for future upgrades:
py -m pip install --upgrade --force-reinstall "https://sync.chuanpiao.ltd/downloads/memory-sync-windows.zip"
  1. Verify the installation:
py -m memory_sync_client.cli --help
  1. Register your account and this device. The command asks for your password securely; do not add --password:
py -m memory_sync_client.cli register --server "https://sync.example.com" --email "you@example.com" --display-name "Your name" --invite-code "invite-from-your-admin"

If you already downloaded an older ZIP or extracted an older directory, you may leave it in place. The install and upgrade command above does not use those files.

Replace the example server, email, and invite code. Local configuration is stored in %APPDATA%\memory-sync\config.json; it contains credentials and a device private key, so never share it.

Daily synchronization

py -m memory_sync_client.cli sync --sync-root "C:\Users\you\Documents\memory"

The command reports the number of downloaded and uploaded files. Back up the folder once before your first sync.

A second computer

Repeat the installation steps on the second computer, then log in to the same account:

py -m memory_sync_client.cli login --server "https://sync.example.com" --email "you@example.com"
py -m memory_sync_client.cli sync --sync-root "C:\Users\you\Documents\memory"

Each computer is registered as a separate device. Never copy the configuration file from the first computer.

Optional periodic sync

daemon requires a download package that contains this subcommand. If py -m memory_sync_client.cli --help does not list daemon, the website is still serving an older package. Use the manual command from “Daily synchronization” instead, and ask the administrator to update the website deployment.

This command syncs every five minutes while the terminal stays open. Stop it with Ctrl+C.

py -m memory_sync_client.cli daemon start --sync-root "C:\Users\you\Documents\memory" --interval 300

py -m memory_sync_client.cli status
py -m memory_sync_client.cli daemon status

Conflicts, offline use, and common problems

  • Conflict: If two devices edit the same file, the command reports a conflict. Inspect the server copy under <memory-folder>\conflicts\ and merge it manually. Your local file is never overwritten.
  • Offline: Keep editing normally, then run py -m memory_sync_client.cli sync again once you are online.
  • Session expired: Run py -m memory_sync_client.cli login --server "server URL" --email "your email" and enter your password.
  • py is not recognized: Run winget install -e --id Python.Python.3.11. If Winget returns 403, run winget source reset --force and winget source update; if that still fails, use the official Python Windows installer.
  • memory-sync is not recognized: You do not need to change PATH; use the py -m memory_sync_client.cli ... commands in this guide.
  • Markdown only: Hidden folders, conflicts, and non-.md files are ignored.