# supermemory-cli

> Claude/Codex skill by [@supermemoryai](https://omgskills.com/library/supermemoryai/index.md) · 113 stars · Updated 2026-10-14

Use the Supermemory CLI (\`supermemory\` 5.x on npm) from the terminal or from scripts and agents. Add content, search, read profiles, forget memories, manage documents, namespaces, connectors, API keys and team members, install coding-agent plugins, migrate a project to the v5 API, and run the local self-hosted server. Covers every command, subcommand, flag and the JSON output contract.

## Install

```sh
git clone https://github.com/supermemoryai/skills /tmp/skills && ln -s /tmp/skills/supermemory-cli ~/.claude/skills/supermemory-cli
```

## From README

and auth Commands that call the API need a login or SUPERMEMORYAPIKEY. help, local and plugin do not. Configuration Three scopes. init writes them, config set edits them. | Scope | File | Holds | | --- | --- | --- | | project | /.supermemory/projects/ /config.json (per machine, never in git) | namespace, optional apiKey | | team | /.supermemory/config.json (commit it) | namespace | | global | /.supermemory/config.json | output, apiUrl, consoleUrl, telemetry | Namespace resolution order: --namespace flag, SUPERMEMORYNAMESPACE, team config, project config. With none of these, content commands stop with "Namespace required". Environment variables | Variable | Effect | | --- | --- | | SUPERMEMORYAPIKEY | API key. Overrides stored credentials and prints a warning when they differ. | | SUPERMEMORYNAMESPACE | Default namespace. Renamed from SUPERMEMORYTAG. | | SUPERMEMORYAPIURL | API base URL, for self-hosted servers. | | SUPERMEMORYCONSOLEURL | Console URL used by open and login.

## Links

- HTML page: https://omgskills.com/library/supermemoryai/skills/supermemory-cli/
- GitHub: https://github.com/supermemoryai/skills
- Author: [@supermemoryai](https://omgskills.com/library/supermemoryai/index.md)

## More from this repo

- [supermemory](https://omgskills.com/library/supermemoryai/skills/supermemory/index.md) — Used to build with the Supermemory v5 API and SDKs (TypeScript \`supermemory\` 5.x, Python \`supermemory\` 5.x,...
   - [@supermemoryai](https://omgskills.com/library/supermemoryai/index.md) · 113 stars
- [svg-animations](https://omgskills.com/library/supermemoryai/skills/svg-animations/index.md) — Used to create beautiful, performant SVG animations and illustrations.
   - [@supermemoryai](https://omgskills.com/library/supermemoryai/index.md) · 112 stars

## More skills by this author

- [supermemory](https://omgskills.com/library/supermemoryai/supermemory/supermemory/index.md) — Supermemory is a state-of-the-art memory and context infrastructure for AI agents.
   - [@supermemoryai](https://omgskills.com/library/supermemoryai/index.md) · 32k stars