Mem0 CLI 是 Mem0 记忆平台的官方命令行界面，用于在终端中完成记忆的增删改查等操作，面向开发者、AI 智能体和 CI/CD 流水线。
用途 Mem0 CLI 让用户无需图形界面即可在命令行中管理 Mem0 记忆：添加、搜索、列出、获取、更新和删除记忆。它适合在脚本、自动化流程和智能体工作流中调用。
安装 提供两种运行时安装方式： Node.js（npm）：npm install -g @mem0/cli Python（pip）：pip install mem0-cli 两个包都会安装一个 mem0 可执行文件，命令、选项和输出格式相同（例外见 Node 与 Python 差异）。
配置 面向智能体的自主设置（无需邮箱、无需仪表盘）： mem0 init --agent --agent-caller <your-name> --json 将 <your-name> 替换为智能体名称（如 claude-code、cursor、codex、cline、aider）。若忘记传 --agent-caller，可在 init 后运行 mem0 identify <your-name>，它会 PATCH 同一个 key，幂等且不中断。该方式会在 5 秒内生成一个评估用 API key，可立即使用。 面向人类的交互式向导：mem0 init 或直接设置环境变量：export MEM0_API_KEY="m0-xxx" API key 获取地址：https://app.mem0.ai/dashboard/api-keys?utm_source=oss&utm_medium=skill-mem0-cli 注意：切勿提交 API key、.env 或 ~/.mem0/config.json。
主要能力与常用命令 添加记忆：mem0 add "I prefer dark mode" --user-id alice 搜索记忆：mem0 search "preferences" --user-id alice 列出某用户全部记忆：mem0 list --user-id alice 获取指定记忆：mem0 get <memory-id> 更新记忆：mem0 update <memory-id> "new text" 删除单条记忆：mem0 delete <memory-id> 删除某用户全部记忆：mem0 delete --all --user-id alice --force
智能体 / JSON 模式 使用 --json 或 --agent 可获得适合 LLM 消费的结构化输出。将标志放在子命令之前（mem0 --json search "q"），两种 CLI 均可用。数据类命令（add、search、list、get、update、delete、import、config、entity、event、status）会把响应包装为标准信封格式，包含 status、command、duration_ms、scope、count、data 等字段；出错时返回 status 为 error 的结构。--agent 是 --json 的别名（mem0 init 除外，那里 --agent 是 Agent Mode 引导标志）。两者都把进度写入 stderr，保证 stdout 是干净可解析的 JSON。
Node 与 Python 差异 --json / --agent 位置：Python 可放在命令行任意位置；Node 仅作为全局选项，需放在子命令之前。mem0 init --json 和 mem0 help --json 在两者中都可放在子命令之后。Agent Mode 引导：Node 仅从 init --agent 或 init --json 启动，Python 还接受根级形式。 --limit：mem0 search --limit 是 Python 独有的 --top-k 别名。 Agent 模式 delete --all 数据：Python 返回 {"deleted": true}（--project 时附带 scope）；Node 返回原始 API 结果。 import JSON 输出：Python 打印带 scope 的信封；Node 省略 scope 并在 JSON 前向 stdout 写入进度行，因此只有 Python 的输出能干净地管道给 jq。 消息文本：空搜索错误与删除 dry-run 页脚略有不同。
常见边界情况 异步处理延迟：mem0 add 后记忆异步处理，搜索新添加内容前等待 2-3 秒，可用 mem0 event list 查看处理状态。 --all 与 --entity 删除模式：mem0 delete --all -u alice 删除该用户全部记忆；mem0 delete --entity -u alice 删除实体本身及其全部记忆（级联）。两者互斥。 --json/--agent 模式下的 --dry-run：mem0 --json delete --all --dry-run 仍需要 --force，然后不打印任何内容也不删除（退出码 0）。Node 对单条和 --entity 的 dry run 也不打印。需用文本模式查看预览。 --dry-run 不保护 --all --project：mem0 delete --all --project --dry-run 会忽略该标志并删除项目内所有记忆。切勿用它预览项目级删除。 实体 ID 解析：若传入任何显式作用域标志（如 --user-id），CLI 只使用显式 ID 并忽略配置默认值；若未传作用域标志，则应用所有配置默认值。 stdin 检测：未提供文本参数且 stdin 是管道或重定向文件时，CLI 从 stdin 读取，适用于 add、search、update。在 --json/--agent 模式下 add 从不读取 stdin（Python 对 search 和 update 也跳过），此时需将文本作为参数传入。
参考文档 可按需加载：命令参考 references/command-reference.md；配置 references/configuration.md；工作流 references/workflows.md。
相关 Mem0 技能 mem0：Python/TypeScript SDK、REST API、框架集成。 mem0-vercel-ai-sdk：带自动记忆的 Vercel AI SDK 提供程序。