Agent skill · software engineering · supermemoryai
supermemory-cli
Use the Supermemory CLI to programmatically manage memories, documents, profiles, tags, connectors, keys, and teams from the terminal. Covers all commands, flags, and usage patterns.
Why this skill is useful
Provides detailed commands and usage patterns for managing memories and documents programmatically, which the AI wouldn't reliably generate on its own.
What it needs
Requires @supermemory/cli installed locally. About 7k tokens when loaded. Last updated 2026-05-19. 92 stars on the source repository.
What this skill does
The Supermemory CLI is the complete interface to Supermemory from the terminal. It lets you add memories, search, manage documents, configure projects, connect external data sources, and administer teams — all programmatically. Installation & Auth Configuration The CLI supports three config scopes: Scope File Use Case ------- ------ ---------- project .supermemory/config.json (gitignored) Per-machine secrets, API keys team .supermemory/team.json (committed) Shared tag, team-wide defaults global ~/.config/supermemory/config.json All projects on this machine Environment Variables Variable Description ---------- ------------- SUPERMEMORYAPIKEY API key for authentication SUPERMEMORYTAG Override default container tag OTELEXPORTEROTLPENDPOINT OpenTelemetry collector endpoint Global Flags Flag Description ------ ------------- --json Force JSON output (machine-readable) --tag Override default container tag for this command --help Show help for any command --- Core Commands add — Ingest content Ingest text, files, or URLs and extract memories into a container tag. Options: --tag <string> — Container tag --stdin — Read content from stdin --title <string> — Document title --metadata <json> — JSON metadata object --id <string> — Custom document ID --batch — Batch mode, reads JSONL from stdin search — Search memories Semantic search across memories with filtering and reranking. Options: --tag <string> — Filter by container tag --limit <number> — Max results (default: 10) --threshold <number> — Similarity threshold 0-1 (default: 0) --rerank — Enable reranking for better relevance --rewrite — Rewrite query using LLM --mode <string> — memories hybrid documents (default: memories) --include <string> — Fields: summary, chunks, memories, document --filter <json> — Metadata filter object remember — Store a memory directly Store a specific fact or memory without ingesting a full document. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills supermemoryai/supermemory-cli