lucasrosati/claude-code-memory-setup

What it solves

本项目提供了一套全面的设置，为 Claude Code 提供持久的长期记忆与代码库感知能力。它解决了两个主要问题：会话间的“失忆症”（用户必须重新解释项目）以及因 Claude 在每个新会话中为了理解结构而重新阅读整个代码库所导致的高代币消耗量。

How it works

该系统使用多层级的方法来管理上下文：

• Persistent Memory: Obsidian Zettelkasten 库作为“第二大脑”，存储决策、架构与会话日志。Claude Code 交互于此库通过 CLAUDE.md 文件与 /resume 和 /save 命令进行进行。
• Codebase Mapping: 它集成了 Graphify 以将代码转换为可查询的知识图谱。Claude 不再是阅读原始文件，而是查询结构地图（基于 AST），这能显著降低代币消耗量。
• Chat Pipeline: 一个基于 Python 的导入管道，将 Claude 的对话（来自 CLI 和 Web app）导出到 Obsidian 库中，作为索引化的笔记。
• Auto-Save Safety Net: 一个注册为 Claude Code 中 SessionEnd hook 的 Python 脚本，会在用户忘记手动保存时，自动提取会话事实并写入一个最小化的日志到库中。

Who it's for

想要降低 API 代币成本（tokens）并希望在多个会话中维持一个持续、可搜索的项目决策与代码库结构知识库的 Claude Code 使用者（开发者）。

Highlights

• Token Efficiency: 宣称通过将完整文件读取替换为图谱查询，每个会话可减少高达 71.5x 的代币使用量。
• Zettelkasten Integration: 使用 Obsidian 中的原子化、互连笔记进行声明式记忆。
• Local Processing: 代码库图谱是通过 tree-sitter AST 在本地处理的，确保在默认模式下代码内容不会离开机器。
• Automated Sync: 包含 cron-scheduled 脚本，，用于同步 chat 历史记录到知识库中。