# supermemory-cli

Teaches your coding agent how to run Supermemory CLI v5 commands to index documents, search context, and manage memories.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 470 installs · ★ 113
- Author: supermemoryai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/supermemoryai/skills/tree/HEAD/supermemory-cli/SKILL.md
- Updated: 2026-10-14
- HTML: https://affpapa.org/en/nevibecode/skills/supermemory-cli

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add supermemoryai/skills --skill supermemory-cli -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/supermemory-cli/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/supermemory-cli/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add supermemoryai/skills --skill supermemory-cli -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/supermemory-cli/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add supermemoryai/skills --skill supermemory-cli -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/supermemory-cli/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install supermemoryai/skills supermemory-cli
```

2. **Manually: put the files in place**
- File: `.github/skills/supermemory-cli/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add supermemoryai/skills --skill supermemory-cli -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/supermemoryai/skills --path supermemory-cli
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/supermemory-cli/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add supermemoryai/skills --skill supermemory-cli -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/supermemoryai/skills/tree/HEAD/supermemory-cli/SKILL.md

## When to use it
- 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
- 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

## Similar
- [supermemory](https://affpapa.org/en/nevibecode/skills/supermemoryai-supermemory.md) — skill · 548 installs
- [memory-search](https://affpapa.org/en/nevibecode/skills/ruvnet-memory-search.md) — skill · 750 installs
- [remember](https://affpapa.org/en/nevibecode/skills/rohitg00-remember.md) — skill · 14000 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/rohitg00-handoff.md) — skill · 13400 installs
- [wrap-up](https://affpapa.org/en/nevibecode/skills/codewithmukesh-wrap-up.md) — skill · 2800 installs
- [memory-reflect](https://affpapa.org/en/nevibecode/skills/basicmachines-co-memory-reflect.md) — skill · 746 installs

From the same set: [supermemoryai/skills](https://affpapa.org/en/nevibecode/by/supermemoryai/skills.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md