supermemory
Installation
SKILL.md
Supermemory v5
Supermemory stores documents, extracts memories from them, and serves three things back: ranked search results, a maintained profile per subject, and the source chunks. Every call is scoped to one namespace: a user id, a project id, or any boundary you want isolated.
This skill documents v5. The legacy v3 and v4 API is deprecated and shuts down on December 31, 2026. If you see containerTag, customId, /v3/, or /v4/ in a codebase, it is on the legacy API; npx supermemory@latest migrate launches a coding agent that upgrades it.
Versions this skill matches
| Client | Version | Install |
|---|---|---|
| TypeScript SDK and CLI | supermemory 5.x |
npm i supermemory |
| Python SDK | supermemory 5.x |
pip install -U supermemory |
| Framework tools (Vercel AI SDK, OpenAI, Mastra, VoltAgent, Claude memory) | @supermemory/tools 3.x |
npm i @supermemory/tools supermemory |
Python framework wrappers (supermemory-openai-sdk, supermemory-agent-framework, pipecat, livekit, cartesia) |
still on the legacy API | prefer the core Python SDK until they ship a v5 release |