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.