How to use the Cloud Sync for claude-mem agent skill

What the cloud-sync skill does

Agent skills are folders of instructions that Claude loads when a request matches them. This one covers claude-mem cloud sync with cmem.ai Pro. When triggered, the agent checks whether your memory database is configured for sync and reports the result, including pending items, the last upload, and any errors.

The agent does not handle your secret token. It asks you to run the official installer in your own terminal. The installer signs you in through the browser and saves the connection settings locally. Once connected, your memories are uploaded to your cmem.ai account.

• Checks sync status: whether it is configured and whether the SyncHub connection is reachable
• Reports device ID, pending counts, last successful flush, and any errors
• Walks you through connecting through the installer

Install the cloud-sync skill

Download the cloud-sync ZIP from this page. Unzip it into one of two locations, depending on how you want to use it: your personal skills folder, or a single project's skills folder.

You can also upload the skill in the Claude apps under Settings → Capabilities → Skills.

• Personal (all projects): unzip into ~/.claude/skills/
• Single project: unzip into the project's .claude/skills/ folder
• Claude apps: Settings → Capabilities → Skills, then upload the skill

Check what you need before you start

The skill assumes several things are already in place. It does not install claude-mem or create your cmem.ai account for you.

• claude-mem installed, with its worker running locally
• Node.js and npx, used to run the claude-mem installer
• A cmem.ai Pro account, and a browser to approve the device sign-in
• curl available in your shell

Trigger the skill with natural requests

You do not need a special command. Describe what you want in ordinary language. The skill is designed to respond to phrases such as the ones below.

• "Set up cloud sync"
• "Sync my memories"
• "What is my sync status?"
• "Back up my memory database to cmem.ai"
• "Why does cloud sync show pending items?"

Connect sync through the installer

If sync is not configured, the agent will ask you to run the installer yourself in your own terminal. Run the command below and choose CMEM Pro when prompted. The installer opens a browser sign-in where you approve a device code. It then writes the connection settings to ~/.claude-mem/settings.json and restarts the worker.

Do not paste your sync token into the chat. The skill is built to never ask for it. If you cannot run the installer interactively, for example on a remote server or in CI, the skill points you to the headless setup guide at https://docs.claude-mem.ai/cmem-pro-headless and you apply its steps yourself.

• Choose CMEM Pro when the installer asks
• Approve the device code in your browser
• The settings file is written with restricted permissions (mode 0600)

Verify the connection and read the status

After the installer finishes, the agent polls the status route for up to 30 seconds. If the worker was not restarted, it restarts it first. A successful setup shows configured as true, the SyncHub connection as reachable, and no last error.

A zero pending count alone is not proof of success, because an empty queue performs no upload. Look for the reachable connection. If the connection is not reachable, the agent reports the error message and suggests running the installer again to refresh the connection.

• Success: configured true, hub reachable true, lastError empty
• Not verified: hub reachable false, even with zero pending items
• Pending counts only include writes made after the SyncHub launch baseline; setup does not migrate older local data

Safety notes: scripts, network and secrets

This skill runs shell scripts and uses the network. It reads the worker port from your local settings, queries the local worker status route, and can send a restart request to the local worker. The agent is instructed never to print, log, or pass the sync token on the command line.

Before you use it, understand what leaves your machine. Cloud sync uploads your observation narratives and full prompt text to your cmem.ai account. If you do not want that content stored with a third-party service, do not connect sync.

• Runs scripts: yes, shell commands in your terminal
• Uses network: yes, to the local worker and to SyncHub through the worker
• Secrets stay out of chat: the installer writes the token directly to your settings file