eugeniughelbur/obsidian-second-brain

Persistent memory for Claude Code, Codex and 6 other AI agents, stored as plain markdown in your Obsidian vault. New: Crew, one shared logbook so Claude Code, Codex, Cursor and Grok Bot know what each other did. 48 commands: semantic search, self-rewriting notes, key-less research, scheduled agents.

obsidian‑second‑brain

它是什么 – 一个开源的“第二大脑”,将大语言模型代理(Claude Code、Grok Bot、Codex、Gemini 等)接入 Obsidian 库。这些代理共享一个通用日志(称为 Crew),以便它们能看到彼此的工作,并且一组 48 个斜杠命令让你可以直接从聊天会话中捕获、组织和检索知识。

为什么重要 – LLM 通常每次对话都从空白状态开始。这个项目赋予它们持久、可搜索的记忆,这些记忆存在于你的 Obsidian 库文件中。你的笔记会自动重写,矛盾会被协调,模式会被综合,而无需你手动复制粘贴或维护单独的知识库。

主要特性(根据 README 描述)

  • Crew 日志 – 一个纯文件夹的工作记录,所有代理均可读写;无需后台守护进程。
  • 48 个命令,分为四层:
    1. 操作(31 个命令)– 保存决策、摄取 URL、PDF、音频、图像、导出库、安排日历事件等。
    2. 思考工具(9 个命令)– 挑战你的想法、揭示隐藏模式、综合见解。
    3. 上下文引擎(1 个命令)– 加载一个简短的“身份”笔记,使每个新会话都从你的关键事实开始。
    4. 研究工具包(7 个命令)– 实时 X 帖子获取、趋势扫描、通过 Perplexity 进行网络研究、YouTube 转录 + 视觉分析、播客摄取等。
  • 自动综合与定时代理 – 夜间、早晨、每周和健康检查代理自动运行,以协调矛盾、创建综合页面并重建索引。
  • 开放知识代谢(OKM) – 事实以时间戳或指针存储,使库能够淘汰过时信息,并保留双时态记录,记录何时何事实为真。
  • AI 优先的笔记格式 – 每个笔记以 ## For future agent 前言和前置元数据开始,专为 LLM 检索而非仅人类阅读设计。
  • 多模型支持 – 通过简单的 CLI 包装器,可与 Claude Code、Grok Bot、Codex、Gemini、OpenCode、Hermes、Pi 等配合使用。
  • Crew 零安装 – 只需一个 curl‑pipe‑bash 脚本;其余部分可在任何 Python 3.10+ 环境中运行,无需额外包。

典型工作流程

  1. 会议后,运行 /obsidian-save;代理提取决策、任务、人员,并创建链接笔记。
  2. 使用 /obsidian-ingest 拖入文件或 URL;Claude(或所选模型)转录、解析并重写 5‑15 个相关页面。
  3. 在决策前使用 /obsidian-challenge,让库揭示过去的失败。
  4. 运行 /obsidian-visualize 获取库结构的图表。
  5. 夜间,后台代理协调矛盾并综合新的模式页面。

安装 – 一行脚本(curl … | bash)安装快速安装脚本,然后在 Claude Code 中运行 /crew setup(或其他代理的等效钩子)将日志指向库内的一个文件夹。

适用人群 – 开发者、创始人、作家、研究人员,或任何已经在使用 Obsidian 做笔记并希望其 LLM 助手跨会话记住并利用这些知识的人。

许可证与社区 – MIT 许可,积极维护(截至 2026 年 10 月为 v0.18),有 GitHub Discussions 论坛、赞助按钮,以及作者定期发布的公开博客文章。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目