Skip to content
Productivity
Skill

/mem-setup

This skill should be used when the user asks to "set up claude-mem", "pair claude-mem", "connect cmem", "add my cmem key", "set up cloud sync in Cowork", or provides cmem.ai Connect values (sync token, user id, SyncHub URL) for this plugin. Configures the claude-mem-cowork

From plugin
claude-mem
94k23 skills1 command1 MCP
Install
$ npx -y skills add thedotmack/claude-mem --skill mem-setup --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/mem-setup

Context preview

The summary Claude sees to decide when to auto-load this skill.

This skill should be used when the user asks to "set up claude-mem", "pair claude-mem", "connect cmem", "add my cmem key", "set up cloud sync in Cowork", or provides cmem.ai Connect values (sync token, user id, SyncHub URL) for this plugin. Configures the claude-mem-cowork

SKILL.md

mem-setup.SKILL.md
name: mem-setup
description: >
  This skill should be used when the user asks to "set up claude-mem", "pair
  claude-mem", "connect cmem", "add my cmem key", "set up cloud sync in
  Cowork", or provides cmem.ai Connect values (sync token, user id, SyncHub
  URL) for this plugin. Configures the claude-mem-cowork plugin credentials.
metadata:
  version: "0.1.0"

Claude-Mem Setup (Cowork pairing)

Configure this plugin with the user's own cmem.ai credentials so hooks can capture and inject memory. Anyone can pair — credentials are per-user configuration, never hardcoded in plugin logic.

What to collect

From **cmem.ai → Connect**, the user has three values:

1. **sync token** (starts with `cm_`) — used as the bearer API key 2. **user id** (UUID) 3. **SyncHub URL** (a workers.dev or cmem.ai URL)

If the user pastes the whole Connect blurb, extract the three values from it. If any are missing, ask for the sync token at minimum — the other two are optional.

Secret handling — non-negotiable

  • Never echo the token back in conversation, put it in a shell argv, or log it.
  • Move it only via file writes (Write/Edit tool) and file reads.

Steps

1. Locate the installed plugin root (this skill's own plugin). Update its `config.json`: set `apiKey` to the sync token, `userId`, and `syncHubUrl`. Leave other settings unless the user asks (`inject` toggles). Project naming is automatic (`cmem_work_*`) and is not configurable. 2. Cowork containers are ephemeral: edits to the installed copy last only for this session. To make pairing permanent, repackage — zip the plugin directory as `<plugin-name>.plugin` and send it to the user to re-install (the cowork-plugin skill's packaging flow). Tell the user this is why. 3. If this machine also has a local claude-mem install (a `~/.claude-mem/` directory exists), optionally write the same values to `~/.claude-mem/settings.json` with mode 0600 (`CLAUDE_MEM_CLOUD_SYNC_TOKEN`, `CLAUDE_MEM_CLOUD_SYNC_USER_ID`, `CLAUDE_MEM_CLOUD_SYNC_HUB_URL` keys — the same keys the local claude-mem cloud-sync pairing writes) — the hook script and the local worker both read it. 4. Verify without exposing the secret:

   node "${CLAUDE_PLUGIN_ROOT}/scripts/cmem-hook.mjs" status

Report the masked output. A `MISSING` key means the write didn't land; a 404 on `/api/hooks/context` is expected until the Pro endpoints deploy (search/injection still work via `/api/mcp`).

Alternate source

Env vars override everything and need no file edits: `CMEM_API_KEY`, `CMEM_USER_ID`, `CMEM_SYNC_HUB_URL`, `CMEM_API_BASE`.

Read more
Ships withclaude-mem

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

Get the whole plugin
Stats
93,645
Stars
8,233
Forks
Active
Maintenance
JavaScript
Language
Apache-2.0
License
3d ago
Last commit
1y ago
Created

Repo: thedotmack/claude-mem

Other skills on claude-mem.