mem-setup

Configure claude-mem Cowork plugin credentials for cloud sync pairing.

92.8k|8.2k|Updated Aug 31, 2025
One-click install
npx skills add https://github.com/thedotmack/claude-mem --skill mem-setup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mem-setup
Source: https://github.com/thedotmack/claude-mem/tree/main/cowork/skills/mem-setup
Command: npx skills add https://github.com/thedotmack/claude-mem --skill mem-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the friction of manually wiring up cloud sync credentials for the claude-mem Cowork plugin, ensuring hooks can capture and inject memory without exposing secrets in conversation or shell history.

Core Features & Use Cases

  • Credential Pairing: Collects the sync token, user id, and SyncHub URL from cmem.ai Connect and writes them to the plugin's config.json.
  • Secret-Safe Handling: Moves tokens only via file writes, never echoing them back or passing them through argv.
  • Local Fallback: Optionally mirrors credentials to ~/.claude-mem/settings.json for local claude-mem installs.
  • Use Case: A user pastes their cmem.ai Connect blurb and the plugin is paired, repackaged, and verified in one flow.

Quick Start

Ask the assistant to set up claude-mem cloud sync by providing your cmem.ai Connect sync token, user id, and SyncHub URL.

Frequently Asked Questions about mem-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up claude-mem cloud sync in Cowork?▼

Provide your cmem.ai Connect sync token, user id, and SyncHub URL. The plugin writes these to its config.json, optionally mirrors them to ~/.claude-mem/settings.json, and verifies the pairing via the cmem-hook status script.

What credentials are needed to pair claude-mem?▼

Three values from cmem.ai Connect are required: a sync token starting with cm_, a user id UUID, and a SyncHub URL. Only the sync token is mandatory; the other two are optional.

Can I use environment variables instead of editing config files?▼

Yes. Set CMEM_API_KEY, CMEM_USER_ID, CMEM_SYNC_HUB_URL, and CMEM_API_BASE as environment variables. These override any file-based configuration without requiring edits.

Why does Cowork plugin pairing not persist across sessions?▼

Cowork containers are ephemeral, so edits to the installed plugin copy last only for the current session. To make pairing permanent, repackage the plugin directory as a .plugin zip and reinstall it.

How do I verify claude-mem pairing without exposing the token?▼

Run node ${CLAUDE_PLUGIN_ROOT}/scripts/cmem-hook.mjs status. The output is masked, so the token is never displayed. A MISSING key indicates the write did not land.