用途
backup-setup 用于管理 claude-mem 的本地备份快照，覆盖三类任务：检查备份状态、启用自动快照、从快照恢复数据库。它操作的对象是本机的 claude-mem 数据库 claude-mem.db。
主要能力
- 状态检查：运行
npx claude-mem backup status，输出最近一次快照时间、快照数量以及最近一次错误（如果有），并显示“Last restore”行，报告最近一次恢复的结果。若提示“Worker is not running”，可先用npx claude-mem start启动 worker 后重试。 - 启用自动快照：可配置间隔小时数（默认 24，范围 1–168）和保留份数（默认 7，范围 1–100）。设置写入 ~/.claude-mem/settings.json，写入时不会回显文件中的其它内容，并把文件权限保持为 0600。
- 按计划生成快照：启用后，已安装的 worker 会按计划对 ~/.claude-mem/claude-mem.db 执行 VACUUM INTO，在会话运行期间也能保持一致性，并保留最新 N 份于 ~/.claude-mem/backups/auto/。每份快照是一个独立的 SQLite 文件，且只留在本机。
- 立即快照：使用
npx claude-mem backup run；首次自动快照约在 worker 启动五分钟后产生。 - 恢复：先用
npx claude-mem backup list列出快照，再执行npx claude-mem restore <file>，之后用 backup status 确认。恢复会暂存快照并重启 worker（worker 未运行时会一并启动）；新 worker 在打开数据库前完成替换，并把被替换的数据库保存为同目录下的 claude-mem-<timestamp>-pre-restore.db，恢复该文件即可撤销此次恢复，它会计入保留份数，恢复结果也会被记录。如果开启了云同步，恢复后的数据库会从快照所在位置继续同步，并可能拉回快照之后到达云端的新变更。
使用方式
根据指令参数进行路由：setup 或空参数时先检查状态，再启用快照；restore 时执行恢复；status 时只检查状态。启用快照可通过向 settings.json 写入 CLAUDE_MEM_BACKUP_ENABLED、CLAUDE_MEM_BACKUP_INTERVAL_HOURS、CLAUDE_MEM_BACKUP_RETAIN_COUNT 三项完成，随后用 npx claude-mem restart 重启 worker 使计划生效，再用 backup status 确认。
适用场景与限制
适用于需要为 claude-mem 本地记忆数据定期留存副本、查看备份健康状态，或在数据异常时回退到某个快照的情况。快照仅保存在本机，不涉及远程存储。settings.json 可能包含凭证，处理时应保留其它无关设置、保持 0600 权限，且不要打印文件内容。仅在状态检查且用户未要求更改或恢复时，报告后即停止。
暂未提供
资料未说明各命令的完整参数选项、快照文件的命名规则细节、跨平台兼容性，也未提供收费或授权信息。