Claude Code Memory

What the plugin provides

Install

# 1. Get an API key at https://app.memorysync.io, then in your shell:
#    macOS/Linux:  export MEMORYSYNC_API_KEY=ms_...   (add to your profile)
#    Windows:      setx MEMORYSYNC_API_KEY ms_...     (new terminals pick it up)

# 2. In Claude Code:
/plugin marketplace add Rafay121/memorysync-plugins
/plugin install memorysync@memorysync

# Restart the session. Verify anytime:
/memorysync:status

Requires Node.js 18+ on PATH for the hook scripts (Claude Code itself does not bundle one). Without an API key the bundled MCP server falls back to an OAuth sign-in and the hooks stay silently off. Updates ship by version bump: /plugin marketplace update memorysync fetches the latest.

What runs when

# Same operation as the hooks perform, shown as the raw MemorySync REST call(s).
#
# Each turn persists verbatim through the episodic plane. The speaker
# seed carries a content hash, so retries and replays converge on one
# stored row — and turns stored here can never double-store against
# MemorySync SDK writes.
curl --request POST https://api.memorysync.io/v1/memory/add_turn \
  --header "X-API-Key: $MEMORYSYNC_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"tenant_id":"acme","user_id":"rafay","source":"claude-code","text":"human: switch the dashboard to teal","speaker":"human@claude::github.com/acme/web-app#h<content-hash>","metadata":{"session_id":"claude::github.com/acme/web-app","project":"github.com/acme/web-app"}}'

Identity and scope resolve automatically: the user from MEMORYSYNC_USER_ID (default: OS username), the project from the git remote (normalized, worktree-aware; MEMORYSYNC_PROJECT to override). Per-prompt recall can be disabled with MEMORYSYNC_PROMPT_RECALL=off; CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC is respected — with it set the plugin makes zero network calls.

Skills and commands

The MCP tools are the same fifteen operations documented at Memory Tools — search, add, list, update, delete, entities, events — connected automatically when the plugin is enabled.

Claude Cowork

Cowork runs the same Claude Code engine in the cloud, and the same plugin works there. Cloud sessions install repo-declared plugins at session start — plugins enabled only in personal settings do not transfer — so teams commit the marketplace and plugin to the repository:

// .claude/settings.json — every collaborator and every Cowork
// cloud session gets MemorySync automatically.
{
  "extraKnownMarketplaces": {
    "memorysync": {
      "source": { "source": "github", "repo": "Rafay121/memorysync-plugins" }
    }
  },
  "enabledPlugins": { "memorysync@memorysync": true }
}

Add MEMORYSYNC_API_KEY to the session’s Cloud Environment variables (cloud sessions do not inherit your shell). The hooks detect $CLAUDE_CODE_REMOTE and persist inline instead of detaching — a cloud sandbox may reap detached children, and a quietly lost turn is worse than a moment of latency. Enterprise note: Anthropic’s Claude-org GitHub marketplace sync rejects public repositories; enterprises fork the marketplace repo privately and register the fork — the same flow Zep documents.

Privacy and data control

• Your prompts and Claude’s replies are stored verbatim in YOUR MemorySync account, scoped to your user and project — delete anytime via /memorysync:recall → delete, or the dashboard.
• Secrets discipline: the memory skill refuses to store tokens, keys and passwords.
• Retrieved memories carry an explicit prompt-injection guard: background data, never instructions.
• Quota exhaustion degrades silently server-side for paid orgs — an over-quota session keeps working, memoryless, and your dashboards still see every skip.

Supported versions

CI runs the hook contract suite (real hook processes, documented stdin payloads, both monthly-quota server modes) and claude plugin validate --strict against the latest Claude Code release on every push, so a schema change upstream fails our pipeline before it can fail your install.

Where to go next