supermemory-cli — Claude Code skill: what it does, how to install
Teaches your coding agent how to run Supermemory CLI v5 commands to index documents, search context, and manage memories.
npx skills add supermemoryai/skills --skill supermemory-cli -a claude-codeWhat supermemory-cli does
This skill provides your agent with the command reference for the supermemory npm package calling the v5 API. It guides the assistant through content ingestion via add, hybrid retrieval with search, profile inspection, and memory deletion. Data isolates cleanly using dedicated namespaces.
The reference covers configuration scopes across project, team, and global levels. The agent learns how to pass structured metadata, apply JSON search filters, and monitor the ingestion pipeline using docs status.
API calls halt immediately with an error unless authenticated via supermemory login or SUPERMEMORY_API_KEY. Only help, local, and plugin run without credentials.
What it helps with
- ingest text, files, and URLs into dedicated namespaces
- run hybrid search across stored memories and chunked documents
- delete outdated memories by identifier or semantic search query
- inspect extraction and indexing pipelines for ingested documents
Example prompts for the agent
- Add this markdown file to the engineering namespace using supermemory
- Search supermemory for our authentication patterns with reranking enabled
- Check the processing status of document doc_abc123
How to install supermemory-cli
1Skills CLI (Vercel)
npx skills add supermemoryai/skills --skill supermemory-cli -a claude-code2Manually: put the files in place
~/.claude/skills/supermemory-cli/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/supermemory-cli/
1Skills CLI (Vercel)
npx skills add supermemoryai/skills --skill supermemory-cli -a codex2Manually: put the files in place
.agents/skills/supermemory-cli/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add supermemoryai/skills --skill supermemory-cli -a cursor2Manually: put the files in place
.cursor/skills/supermemory-cli/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install supermemoryai/skills supermemory-cli2Manually: put the files in place
.github/skills/supermemory-cli/SKILL.md1Skills CLI (Vercel)
npx skills add supermemoryai/skills --skill supermemory-cli -a gemini-cli2Platform CLI
gemini skills install https://github.com/supermemoryai/skills --path supermemory-cliManually: put the files in place
.devin/skills/supermemory-cli/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add supermemoryai/skills --skill supermemory-cli -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about supermemory-cli
How do I install supermemory-cli in Claude Code?
Run npx skills add supermemoryai/skills --skill supermemory-cli -a claude-code. This adds the full CLI reference to your agent.
What does the supermemory-cli skill do?
It provides your agent with syntactical rules, flags, and JSON contracts for the Supermemory v5 CLI. The assistant learns how to add files, query memories, and manage configurations.
What credentials does the CLI require?
You must run supermemory login or export SUPERMEMORY_API_KEY in your environment. Basic commands like help, local, and plugin run without an API key.