Agent skill

Claude-Mem Cloud Sync

by thedotmack in thedotmack/claude-mem

Checks claude-mem cloud sync status and guides you through connecting a cmem.ai Pro account without the sync token ever passing through the chat.

Apache-2.0Auto-check: notesAgent Workflows

Install Claude-Mem Cloud Sync

skills CLI
$ npx skills add thedotmack/claude-mem --skill cloud-sync -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install thedotmack/claude-mem cloud-sync --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/thedotmack/claude-mem.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugin/skills/cloud-sync .claude/skills/cloud-sync && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cloud-sync
GitHub stars
97k
Token cost
~1k tokens
SKILL.md length
479 words
Files
1
Skills in repo
26
Repo updated
First seen
Licence
Apache-2.0

At a glance

Checks claude-mem cloud sync status and guides you through connecting a cmem.ai Pro account without the sync token ever passing through the chat.

  • Works in 4 steps: Check status → Connect through the installer → Verify → …
  • Setting up cloud sync for claude-mem with a cmem.ai Pro account
  • SKILL.md covers 1. Check status, 2. Connect through the installer, 3. Verify and 4. Report
  • Calls curl, npx and node

What it does

The skill handles backing up and syncing claude-mem's memory database to a cmem.ai Pro account. The installed worker syncs through SyncHub with one client and one durable operation log, so there is no separate sync daemon. The first step queries the worker's local status route and reads the answer: configured and reachable means reporting the device id, pending counts, last flush time, last error and the hub's head and checkpoint; configured but unreachable means reporting the hub error and saying the connection is unverified.

When sync is not configured, you are asked to run npx claude-mem install in your own terminal and choose CMEM Pro. The installer signs you in through the browser with a device code and writes the token, user id and SyncHub URL into ~/.claude-mem/settings.json itself. The agent never asks for, prints or logs the token, since a pasted secret would land in a transcript that claude-mem can capture and sync. For machines without an interactive terminal, the skill points to a headless setup guide that you apply yourself.

When your agent uses it

  • Setting up cloud sync for claude-mem with a cmem.ai Pro account
  • Checking whether memories are syncing and what is still pending
  • Backing up the memory database to your cmem.ai account

Example prompts

  • “Set up cloud sync for my claude-mem memories.”
  • “What is the sync status on this machine?”
  • “I want my memory database backed up to my cmem.ai account. Walk me through it.”

Requirements

  • A running claude-mem worker
  • A cmem.ai Pro account
  • Node.js with npx to run the installer in your own terminal
  • Pre-approved tools (allowed-tools): Bash, Read, AskUserQuestion

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Check status
  2. Connect through the installer
  3. Verify
  4. Report

What it can do on your machine

Read from SKILL.md and the folder at commit 71ddd11. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • npx
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.claude-mem.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Claude-Mem Cloud Sync loads about 1k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 479 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, AskUserQuestion

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from thedotmack/claude-mem at commit 71ddd11, republished under its Apache-2.0 licence (© thedotmack). 479 words, ~1,028 tokens.

Download SKILL.mdSave it as .claude/skills/cloud-sync/SKILL.md (or your agent's skills folder).
name
cloud-sync
description
Set up or check claude-mem cloud sync with cmem.ai Pro. Use when the user says "set up cloud sync", "sync my memories", "cmem pro", "cloud backup", "sync status", or wants their memory database backed up or synced to their cmem.ai account.
allowed-tools
Bash, Read, AskUserQuestion

Cloud Sync (cmem.ai Pro)

The installed worker syncs through SyncHub. There is one client, one durable operation log, and no separate sync daemon. This skill checks status and points the user to the installer's cmem.ai sign-in, which writes the connection.

Security rule: never ask the user to paste the sync token into this chat, and never put it in a command you write, print it, put it in argv, or log it. A secret pasted into a chat lands in the transcript, which claude-mem itself can capture and sync. The installer writes the token to ~/.claude-mem/settings.json (mode 0600) without it ever passing through this conversation.

1. Check status

Resolve the worker port and query the always-registered status route:

bash
PORT="${CLAUDE_MEM_WORKER_PORT:-$(node -e "const fs=require('fs'),p=require('path'),os=require('os');const uid=(typeof process.getuid==='function'?process.getuid():77);const fallback=String(37700+(uid%100));try{const s=JSON.parse(fs.readFileSync(p.join(os.homedir(),'.claude-mem','settings.json'),'utf-8'));process.stdout.write(String(s.CLAUDE_MEM_WORKER_PORT||fallback));}catch{process.stdout.write(fallback);}" 2>/dev/null)}"
curl -s "http://127.0.0.1:${PORT}/api/sync/status"
  • configured: true and hub.reachable: true → the worker completed an authenticated GET /v1/sync/status against SyncHub. Report deviceId, pending counts, lastFlushAt, lastError, and the Hub head/checkpoint; stop unless the user asked to replace the connection.
  • configured: true and hub.reachable: false → report hub.error and say the SyncHub connection is not verified. A zero pending count or lastError: null is not success because an empty queue performs no push.
  • configured: false → continue.
  • Connection refused, 404, or 503 immediately after restart → retry every three seconds for about 30 seconds before diagnosing the worker.

2. Connect through the installer

Ask the user to run this in their own terminal:

bash
npx claude-mem install

and to choose CMEM Pro when the installer asks. The installer signs them in through the browser (they approve a device code), then writes the sync token, user id and SyncHub URL into ~/.claude-mem/settings.json itself and restarts the worker. Nothing secret is typed into this chat.

If the user cannot run the installer interactively (CI, a remote box), point them to the headless setup guide, https://docs.claude-mem.ai/cmem-pro-headless, and let them apply its manual recipe in their own terminal or editor. Do not collect the values yourself.

The worker mints and persists a device id on first start and defaults the device name to the hostname.

Show full SKILL.md (154 more words)Show less

3. Verify

Once the installer finishes, poll the status route every five seconds for up to 30 seconds. If the worker was not restarted, restart it first:

bash
curl -s -X POST "http://127.0.0.1:${PORT}/api/admin/restart"

Success means configured: true, hub.reachable: true, and lastError: null. The local route always makes an authenticated, read-only SyncHub status probe, even when every pending count is zero; it never uses a legacy cmem.ai Pro status route and never appends or advances sync state. Pending counts describe only writes made after the SyncHub launch baseline; setup does not migrate a pre-launch local corpus.

If hub.reachable is false, report hub.error. If lastError is non-null, report it too, and suggest running npx claude-mem install again to refresh the connection. Never include the token.

4. Report

Report device id, pending counts, last successful flush, Hub reachability and checkpoint, and any Hub/flush error. End with this privacy note:

Cloud sync uploads your observation narratives and full prompt text to your cmem.ai account.

© thedotmack, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugin/skills/cloud-sync of thedotmack/claude-mem.

Open the folder on GitHubat commit 71ddd11

Compare with similar skills

Claude-Mem Cloud Sync next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Claude-Mem Cloud Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Claude-Mem Cloud Sync this skillthedotmack/claude-mem97k—~1kAutomated safety check: NotesApache-2.0
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
Beads Task Memorygastownhall/beads28k—~1.2kAutomated safety check: PassMIT
MemPalace Memory SearchMemPalace/mempalace59k—~1.4kAutomated safety check: PassMIT
Reflect on Session Learningscursor/plugins10k5 repos~1.2kAutomated safety check: PassNone
Compound Learning WriterEveryInc/compound-engineering-plugin25k—~2kAutomated safety check: PassMIT

Similar skills

  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 6 days ago
    Agent WorkflowsAuto-check passed
  • Beads Task Memory

    gastownhall/beads

    Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.

    28k GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • MemPalace Memory Search

    MemPalace/mempalace

    Mines project files and conversation exports into a local, searchable memory palace and recalls past work by semantic search through the mempalace CLI.

    59k GitHub stars~1.4k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Official

    Starts three parallel reviewer subagents over the current conversation transcript, then turns their findings into concrete edits to existing skills.

    10k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Compound Learning Writer

    EveryInc/compound-engineering-plugin

    Records one solved and verified problem as a durable learning in the repository, but only when the reasoning is not already clear from the final code, tests or docs.

    25k GitHub stars~2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.

    24k GitHub stars~3.1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from thedotmack/claude-mem

All 26 skills in this repo
  • Walks you through creating, installing and verifying a custom claude-mem mode, including note types, tags and optional Telegram alerts for chosen memories.

    97k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Project Timeline Report

    thedotmack/claude-mem

    Writes a narrative Journey Into report on a project's whole development history, built from the timeline that claude-mem has recorded.

    97k GitHub starsUsed in 1 repo~3.1k tokens
    Auto-check passed
  • Pull Request Babysitter

    thedotmack/claude-mem

    Keeps watching a pull request, fixing real review and CI problems and resolving stale threads, until it is clean and ready to merge.

    97k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Claude-Mem Install for Grok Bot

    thedotmack/claude-mem

    Use this when setting up claude-mem on Grok Bot: local worker plus CMEM Pro observer (default), optional host-login observer, or remote cmem.ai. No Cursor…

    97k GitHub stars~440 tokensUpdated today
    Auto-check passed
  • Audits a design against Dieter Rams' ten principles of good design, scores each with evidence, and hands off a make-plan prompt for a new, refined or redesigned outcome.

    97k GitHub stars~4.6k tokensUpdated today
    Auto-check passed
  • Session Handoff Document

    thedotmack/claude-mem

    Writes a HANDOFF.md capturing goal, state, files, failed attempts and next steps so a fresh agent session can continue exactly where this one stopped.

    97k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Categories

Questions about Claude-Mem Cloud Sync

What does Claude-Mem Cloud Sync do?

Checks claude-mem cloud sync status and guides you through connecting a cmem.ai Pro account without the sync token ever passing through the chat. ai Pro account. The installed worker syncs through SyncHub with one client and one durable operation log, so there is no separate sync daemon.

When should I use Claude-Mem Cloud Sync?

Claude-Mem Cloud Sync fits situations like: setting up cloud sync for claude-mem with a cmem.ai Pro account; checking whether memories are syncing and what is still pending; backing up the memory database to your cmem.ai account.

How do I install Claude-Mem Cloud Sync in Claude Code?

Run `npx skills add thedotmack/claude-mem --skill cloud-sync -a claude-code`. Or copy the skill folder (plugin/skills/cloud-sync in thedotmack/claude-mem) into .claude/skills/cloud-sync in your project. Claude Code loads it when a task matches its description.

How do I install Claude-Mem Cloud Sync in Codex?

Run `npx skills add thedotmack/claude-mem --skill cloud-sync -a codex`. Or copy the skill folder (plugin/skills/cloud-sync in thedotmack/claude-mem) into .agents/skills/cloud-sync in your project. Codex loads it when a task matches its description.

Can I use Claude-Mem Cloud Sync in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thedotmack/claude-mem --skill cloud-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cloud-sync, .gemini/skills/cloud-sync, .github/skills/cloud-sync and .opencode/skills/cloud-sync in your project.

What does Claude-Mem Cloud Sync need to run?

Going by SKILL.md and its folder, Claude-Mem Cloud Sync needs the command-line tools its instructions call (curl, npx and node). Our summary lists: A running claude-mem worker; A cmem.ai Pro account; Node.js with npx to run the installer in your own terminal. Its frontmatter pre-approves these tools: Bash, Read, AskUserQuestion.

Does Claude-Mem Cloud Sync access the network?

SKILL.md names 1 domain. As links in the text: docs.claude-mem.ai. This is read from the text; nothing was executed.

Is Claude-Mem Cloud Sync safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Claude-Mem Cloud Sync use?

Claude-Mem Cloud Sync is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Claude-Mem Cloud Sync use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Claude-Mem Cloud Sync?

Skills that share tags, products or a category with Claude-Mem Cloud Sync: Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars), Beads Task Memory (gastownhall/beads, 28k stars), MemPalace Memory Search (MemPalace/mempalace, 59k stars) and Reflect on Session Learnings (cursor/plugins, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Claude-Mem Cloud Sync?

thedotmack (a GitHub user) maintains it in thedotmack/claude-mem, which has 97,250 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on October 7, 2026.

Source: thedotmack/claude-mem on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.