supermemory-cli

Manage Supermemory memories, documents, tags, connectors, and teams from the terminal.

2|1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/zester4/zilmate --skill supermemory-cli-zester4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: supermemory-cli
Source: https://github.com/zester4/zilmate/tree/main/.agents/skills/supermemory-cli
Command: npx skills add https://github.com/zester4/zilmate --skill supermemory-cli-zester4

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @supermemory/cli.

What problem does it solve? Managing long-term memory for AI agents and applications requires programmatic control over memories, documents, and user profiles, which is tedious through a web UI alone. This Skill provides complete terminal-based control of the Supermemory platform so you can script, automate, and integrate memory operations into any workflow. ## Core Features & Use Cases - Memory Operations: Add, search, remember, forget, and update memories with semantic search, reranking, metadata filtering, and container tag scoping. - Document & Tag Management: Ingest files and URLs, track processing status, organize content with container tags, and merge or delete tags as projects evolve. - Administration & Integrations: Manage API keys, connect Google Drive or Notion connectors, configure IDE plugins like Claude Code and Cursor, and administer team members. - Use Case: A developer building a support bot pipes each resolved ticket into Supermemory via supermemory add --stdin --tag support, then the bot retrieves relevant context with supermemory search before answering new tickets. ## Quick Start Install the Supermemory CLI with npm, run supermemory login to authenticate, then ask the agent to add a memory or search existing memories for a given container tag.

Frequently Asked Questions about supermemory-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add memories with the Supermemory CLI?

Use supermemory add followed by text, a file path, or a URL to ingest content into a container tag. You can also pipe content via stdin with the --stdin flag or use --batch for JSONL bulk ingestion.

How do I search memories semantically from the terminal?

Run supermemory search with your query and optional flags like --tag, --limit, --rerank, and --threshold. The --mode flag switches between memories, hybrid, and documents search, and --filter accepts JSON metadata filters.

Can I use the Supermemory CLI in CI/CD pipelines?

Yes, set the SUPERMEMORY_API_KEY environment variable for authentication and use the --json flag on any command for machine-readable output. This supports scripted ingestion, status checks, and jq-based parsing in automation.

What commands work with a scoped Supermemory API key?

Scoped keys restricted to one container tag only support search, add, remember, forget, update, profile, and whoami. The tag is applied automatically from the key scope, so no --tag flag is needed.

Does the Supermemory CLI support external data source connectors?

Yes, the connectors command connects services like Google Drive, Notion, and OneDrive through an OAuth flow. You can trigger syncs, view history, list synced resources, and disconnect connectors from the terminal.