obsidian-second-brain

让 Claude Code 记住一切，告别每次重复解释

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 641 🐛 待处理 6 👀 关注 31

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 5219

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，可自行部署使用。

项目预览

obsidian-second-brain 项目界面预览图 — 图片来源：项目官网

项目数据

分类智能体

开发团队eugeniughelbur

官网地址https://theaioperator.io

GitHubhttps://github.com/eugeniughelbur/obsidian-second-brain

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent-memory,agent-skills,ai-agents,ai-note-taking,ai-second-brain,claude,claude-code,claude-code-skill,claude-memory,claude-plugin,claude-skill,codex,karpathy-llm-wiki,knowledge-graph,knowledge-management,obsidian,obsidian-md,personal-knowledge-management,pkm,second-brain

GitHub 星标★ 5219

上线时间2026-03-24 00:00:00

代码更新2026-11-08

仓库体积25.5 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数4

项目介绍

obsidian-second-brain 是一个为 Claude Code 等 6 种 CLI 智能体提供持久化记忆的开源项目。它解决的是 AI 助手每次会话后遗忘上下文的问题，将记忆以纯 Markdown 文件形式存储在用户的 Obsidian 库中，实现跨会话的知识积累。项目提供 45 个命令，涵盖混合语义搜索、笔记自改写、免 API 密钥的网络研究，以及定时维护知识库的调度智能体。核心能力包括：将项目决策、人员信息等结构化沉淀为可检索的笔记；通过语义搜索快速召回相关记忆；支持智能体在后台自动整理和更新笔记。它让 AI 助手从无状态工具进化为有长期记忆的协作伙伴，减少重复解释，提升工作效率。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5219

技术标签

agent-memory agent-skills ai-agents claude claude-code

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Claude Code（或 README 列出的其余六种 CLI 平台之一：Codex CLI、Gemini CLI、Grok Bot、OpenCode、Her
git（用于获取项目源码）
uv（Python 辅助脚本：健康检查、研究工具包、bootstrap）
jq：仅在「经典脚本安装」路径必需，缺失时 scripts/setup.sh 会直接退出
可选：Ollama（本地语义搜索）、openai-whisper（首次音频 ingest 时自动安装并拉取 PyTorch）

安装与启动步骤

1准备环境依赖

先装好 Claude Code 或其它受支持的 CLI 平台，并确认 git、uv 可用。若不使用插件方式安装，还需额外安装 jq，否则经典脚本安装会中断。
2获取项目源码

把项目源码放到本地任意目录，后续命令中的 /path/to/obsidian-second-brain 即指该目录的绝对路径。
3构建目标平台包

项目是「一套代码、八种构建」，需按目标平台编译。以 Hermes 为例，构建产物输出到 dist/hermes/。
```
bash scripts/build.sh --platform hermes
```
4skills.sh 安装共享技能树

在 Obsidian 库根目录执行，写入一份共享的 .agents/skills/ 技能树，可同时指定多个平台参数。
```
npx skills add /path/to/obsidian-second-brain/dist/agent-skills -a antigravity -a codex -a opencode
```
5经典脚本安装

脚本安装路径会安全地编辑 ~/.claude/settings.json，因此本机必须先有 jq。插件方式安装则不需要这一步。
```
bash scripts/setup.sh
```
6按平台补装说明

Grok Bot 需看 dist/grok-bot/INSTALL.md；Hermes 需按 dist/hermes/INSTALL.md 把技能复制到 ~/.hermes/skills/ 或添加为 tap。
7设置库路径变量

把 OBSIDIAN_VAULT_PATH 指向你的 Obsidian 库根目录，Grok Bot 等平台的 vault I/O 依赖它定位笔记。
```
export OBSIDIAN_VAULT_PATH=/your/vault/path
```

关键配置

配置项	必填	说明	示例
`OBSIDIAN_VAULT_PATH`	是	指向 Obsidian 库根目录，供各平台读写记忆笔记	`/your/vault/path`
`OPENROUTER_API_KEY`	否	把 OpenCode 指向 Hermes 等模型时需要，先认证一次即可	`sk-or-v1-xxxxxxxx`

如何确认成功

在智能体里执行 /obsidian-daily 或 /obsidian-save，能正常读取库并生成或更新笔记即说明安装成功。

常见问题

Q：核心功能需要 API 密钥吗？

A：不需要。README 明确说明核心 vault 命令无需 API 密钥；只有 X 读取、Perplexity 深度研究等外部能力才依赖对应平台。

Q：缺少 jq 会怎样？

A：经典脚本安装会直接退出。scripts/setup.sh 用 jq 安全编辑 ~/.claude/settings.json，所以必须先装 jq；走插件安装路径则不受影响。

Q：音频转写需要提前准备什么？

A：使用本地 Whisper 转写，openai-whisper 会在首次音频 ingest 时自动安装并拉取 PyTorch，首次会比较耗时。

Q：可以搭配非 Claude 的模型吗？

A：可以。技能是模型无关的，OpenCode、Codex、Gemini 构建都是纯指令文件，模型由宿主 CLI 决定。Hermes 另有独立构建。

Q：Grok Bot 支持定时维护吗？

A：不支持。README 指出 Grok Bot 没有 hook runtime，因此没有 hooks 和定时智能体，定时整理需换用其它平台。

注意事项

记忆以纯 Markdown 文件形式存在你的 Obsidian 库里，切换 CLI 平台也不会丢失。
八个构建共用同一套源码与配置源，vault 行为一致，差异只在安装路径和调度文件（CLAUDE.md / AGENTS.md / GEMINI.md 等）。
scripts/conformance_report.py 会在 CI 中校验每个构建是否产出非空目录、脚本路径可解析、文档可达，可据此确认构建完整。
定时夜间智能体、生命周期 hook 等能力依赖宿主平台，Grok Bot 与 Hermes 的部分集成仍在推进中。

核心亮点

纯 Markdown 存储，数据完全本地可控，与 Obsidian 生态无缝集成
45 个命令覆盖搜索、改写、研究、调度，功能全面且可扩展
支持 6 种 CLI 智能体，不锁定单一 AI 工具

不足之处

依赖 Obsidian 库结构，对非 Obsidian 用户有迁移成本
文档/社区待观察

适用场景

开发者在多项目间切换，需要 AI 助手保持项目上下文
团队使用 CLI 智能体协作，需共享项目决策和人员知识
个人知识管理，希望 AI 自动整理和关联笔记

替代项目

mem0、Letta、Basic Memory

上一篇：yoagent

下一篇：claude-smart