🌐 English | 日本語 | 中文 | 한국어

Obsidian Mind

一个为 AI 编程 Agent 提供持久化记忆的 Obsidian 知识库。 专为 Claude Code 构建，同时提供适用于 Codex CLI 和 Gemini CLI 的钩子（Hooks）。只需开启会话，随口记录你的日常，剩下的工作（如笔记、链接、索引、绩效追踪）全部交由 Agent 处理。每一次对话都是在累积知识。

---

🔴 问题所在

AI 编程 Agent 虽然强大，但它们会“遗忘”。每一次会话都从零开始——它们不了解你的目标、团队、工作模式或取得的成就。你不得不反复解释相同的事情，也容易丢失三次对话前做出的决策。知识从未产生复利。

🟢 解决方案

赋予你的 Agent 一个大脑。

You: "start session"
Agent: *reads North Star, checks active projects, scans recent memories*
Agent: "You're working on Project Alpha, blocked on the BE contract.
        Last session you decided to split the coordinator. Your 1:1
        with your manager is tomorrow — review brief is ready."

适用于 Claude Code（全面支持）、Codex CLI 和 Gemini CLI —— 同样的钩子、同样的命令、同样的知识库。

通过 shardmind install 或 git clone 安装 —— 无论哪种方式，最终的知识库结构都是一样的。

---

⚡ 应用演示

早间启动：

/om-standup
# → 加载 North Star（北极星目标）、活跃项目、开放任务、近期 git 变更
# → "You have 2 active projects. The auth refactor is blocked on API contract.
#    Your 1:1 with Sarah is at 2pm — last time she flagged observability."

会后脑力倾倒（Brain dump）：

/om-dump Just had a 1:1 with Sarah. She's happy with the auth work but wants
us to add error monitoring before release. Also, Tom mentioned the cache
migration is deferred to Q2 — we decided to focus on the API contract first.
Decision: defer Redis migration. Win: Sarah praised the auth architecture.

→ 更新 org/people/Sarah Chen.md（会议背景）
→ 创建 work/1-1/Sarah 2026-03-26.md（关键要点）
→ 创建决策记录: "Defer Redis migration to Q2"
→ 添加至 perf/Brag Doc.md: "Auth architecture praised by manager"
→ 更新 work/active/Auth Refactor.md（添加错误监控任务）

事件响应：

/om-incident-capture https://slack.com/archives/C0INCIDENT/p123456
# → slack-archaeologist 读取每条消息、线程和个人资料
# → people-profiler 为涉及的新人员创建笔记
# → 生成完整的时间线、根本原因分析、Brag Doc（成就文档）条目

下班收尾：

You: "wrap up"
# → 验证所有笔记是否具备链接
# → 更新索引
# → brag-spotter 发现尚未记录的成就
# → 提出改进建议

---

🚀 快速上手

📦 通过 ShardMind 安装（推荐）

npm install -g shardmind
mkdir my-vault && cd my-vault
shardmind install github:breferrari/obsidian-mind

shardmind install 会写入当前目录，因此请先创建并进入一个新文件夹。安装向导会收集你的姓名、组织、知识库用途、需包含的 Agent 类型，以及是否启用 QMD；随后 ShardMind 会初始化 git，引导配置 QMD，并根据你的回答个性化设置 brain/North Star.md。接着执行以下步骤：

1. 将安装后的文件夹作为 Obsidian 知识库 打开
2. 在设置 → 常规中启用 Obsidian CLI（需要 Obsidian 1.12+）
3. 在知识库目录中运行你的 Agent：claude、codex 或 gemini
4. 开始讨论工作

ShardMind 是 Obsidian 知识库模板的包管理器。安装过程会添加一个 .shardmind/ 辅助目录，用于驱动向导、可选模块（不使用的可以跳过）以及三路合并升级。在保持默认值的情况下，该安装与 git clone 在字节层面完全等价，完美保留了原生的克隆体验。如果你从已安装的知识库中删除 .shardmind/ 和 shard-values.yaml，它依然能正常工作：ShardMind 是增量式工具，而非负载性依赖。

或直接克隆

git clone https://github.com/breferrari/obsidian-mind.git

或者将其作为 GitHub 模板 使用。