SCMD icon

SCMD

SCMD 是一款本地浏览器评审工具,用于管理持久化 Claude Code 记忆:检查、筛选、编辑、删除和恢复条目,并在确认前暂存所有更改。

SCMD

本地控制 Claude Code 记忆

SCMD 是一款用于持久化 Claude Code 记忆的本地评审工具。它会将 Claude Code 项目目录中的记忆加载到基于浏览器的评审界面中,让用户检查项目和记忆详情、搜索和筛选条目,并决定哪些内容应保留、删除、跳过或编辑。

该工作流将评审与修改分开:在用户确认 Apply 之前,所有决定都会暂存。接受的编辑会更新记忆及其匹配的 `MEMORY.md` 条目;接受的删除会将记忆文件移至本地回收区,并附带元数据以便之后恢复。SCMD 将服务器绑定到 `127.0.0.1`,使用每次启动生成的请求令牌,并且不会将数据发送到 SCMD 服务。

核心功能

记忆发现

将默认 Claude Code 项目位置中的记忆以卡片形式呈现,按从旧到新的顺序排列,并提供项目和记忆详情供检查。

搜索和筛选

按项目或记忆类型筛选,并搜索记忆文本,包括只读的 `CLAUDE.md` 指令,以便集中评审相关条目。

暂存决定

在评审过程中,将保留、删除、跳过和撤销决定暂存在浏览器中,而不是立即修改文件。

受控应用

在确认后应用批量操作,将已删除的记忆移入可恢复的回收区,并拒绝覆盖加载后发生变化的记忆。

来源和重写上下文

当记忆来源可用时,可以显示与其关联的会话消息;还可以通过本地 Claude Code CLI 请求重写,或在应用前接受手动编辑。

本地评审服务器

作为本地服务器运行,为决定和文件状态变化提供实时更新;无需运行时依赖,并使用每次启动生成的令牌保护 API 请求。

实际用途

  • 定期清理记忆

    在项目中积累的记忆继续影响后续 Claude Code 会话之前,对其进行评审。搜索记忆文本、检查项目上下文,并为一次确认的批量操作暂存保留、跳过、删除或编辑决定。

  • 追溯可疑上下文

    当可以找到来源时,通过查看记忆产生的会话消息,调查某条特定记忆为何存在,然后决定保存的上下文是否仍然合适。

  • 更正或重写记忆

    无需立即编辑文件,即可完善过时或措辞不佳的记忆条目。通过本地 Claude Code CLI 请求重写,或进行手动编辑,检查暂存结果,并仅在确认后应用。

  • 恢复已评审的删除

    当再次需要某条记忆时,从已接受的删除中恢复它。使用明确的 Restore 操作放回记忆及其匹配的 `MEMORY.md` 行,或使用 Purge 对选定的回收区运行执行单独的永久删除。

Pros and Cons

Pros

  • 在明确执行 Apply 之前,将评审决定与文件更改分开。
  • 为接受删除的记忆提供可恢复回收区,并防止覆盖加载后发生变化的记忆。
  • 在一个本地评审工作流中提供搜索、项目和记忆类型筛选、来源上下文以及文件状态实时更新。
  • 使用本地主机服务器和每次启动生成的 API 令牌;评审数据不会发送到 SCMD 遥测系统或 SCMD 服务。

Cons

  • 该工具专注于 Claude Code 的记忆位置和工作流,而不是通用文件或知识库管理。
  • 需要 Node.js 18 或更高版本;在 Windows 上,按照文档所述的 Claude Code 启动路径,目前需要使用 Git Bash。
  • 现有文档未说明团队协作、托管访问或多用户支持。

FAQ

运行 SCMD 需要什么?

安装 Node.js 18 或更高版本,包括 npm 和 npx。主要启动方式是 Claude Code 插件;也可以通过 npx 在终端中启动。Windows 目前需要使用 Git Bash 来运行插件命令和 Shell 代码片段。

如何从 Claude Code 启动 SCMD?

在 Claude Code 中,使用 `/plugin marketplace add nelsonjohnsolo/scmd` 添加市场,使用 `/plugin install scmd@scmd` 安装插件,重新加载插件,然后运行 `/scmd:run`。插件会在后台启动 SCMD,并在会话中显示本地评审 URL。

SCMD 会评审哪些数据?

默认情况下,SCMD 会读取 `~/.claude/projects` 下的记忆文件和索引,以及相关的项目会话记录和全局或项目级 `CLAUDE.md` 文件。可以通过 `--root <dir>` 提供自定义的 Claude 配置或自动记忆位置。

应用更改后可以恢复吗?

评审决定会一直暂存在浏览器中,直到确认 Apply。接受删除的记忆会移动到 `~/.scmd/trash/`,并附带恢复元数据;接受的编辑会更新记忆及其匹配的索引条目。Restore 和 Purge 是需要明确执行的独立操作。

Quick Facts

类别
开发者工具
主要工作流
发现 → 评审 → 确认 → 恢复
适用场景
Claude Code 记忆评审
运行环境要求
Node.js 18 或更高版本
部署模式
运行于 127.0.0.1 的本地服务器
许可证
MIT