v2.0.0-rc1 -- 7-persona virtual team

Install in 30 seconds

Paste into Claude Code, Codex, OpenCode, or Gemini -- then restart the host.

bash / macOS / Linux

git clone --depth 1 https://github.com/2233admin/obsidian-llm-wiki.git ~/obsidian-llm-wiki-src
cd ~/obsidian-llm-wiki-src && ./setup

PowerShell / Windows

git clone --depth 1 https://github.com/2233admin/obsidian-llm-wiki.git "$HOME\obsidian-llm-wiki-src"
cd "$HOME\obsidian-llm-wiki-src"; .\setup.ps1

Pick a host explicitly

./setup --host claude     # Claude Code
./setup --host codex      # Codex CLI
./setup --host opencode   # OpenCode
./setup --host gemini     # Gemini CLI

After install

• 7 /vault-* personas land in your host's skills directory (~1.7 MB, not the full 64 MB repo)
• Printed .mcp.json snippet goes into your host's MCP config
• CLAUDE.md persona block is appended automatically
• Restart the agent host for MCP registration to take effect

7 personas

Name	What it does
vault-librarian	reads, searches, cites from the vault
vault-architect	compiles concept graph, suggests refactors
vault-curator	finds orphans, dead links, duplicates, stale notes
vault-teacher	explains a note in context of its neighbors
vault-historian	answers what you were thinking on date X
vault-janitor	proposes cleanups, dry-run by default
vault-gardener	proactive health audit

What's new since v1.0

• 7-persona virtual team (v1.0 was MCP plumbing only)
• Operations-driven MCP core: single source of truth for 38 tools
• Recipe framework: voile / feishu / x-to-vault collectors in-tree
• Headless-first: filesystem adapter always available; Obsidian / memU / GitNexus optional
• Auto-generated tool reference with CI drift guard
• Display brand "LLM Wiki Bridge"; slug unchanged for install / npm / URL continuity

Docs

• README: https://github.com/2233admin/obsidian-llm-wiki#readme
• MCP tool reference: https://github.com/2233admin/obsidian-llm-wiki/blob/v2.0.0-rc1/docs/mcp-tools-reference.md
• Install troubleshooting: https://github.com/2233admin/obsidian-llm-wiki/blob/v2.0.0-rc1/docs/INSTALL.md
• Why not just grep: https://github.com/2233admin/obsidian-llm-wiki/blob/v2.0.0-rc1/docs/WHY_NOT_JUST_GREP.md

Notes

Release candidate. File issues at https://github.com/2233admin/obsidian-llm-wiki/issues.

MIT licensed.

v1.0.0 -- Knowledge OS for Claude Code + Obsidian

vault-mind v1.0.0

Knowledge OS for Claude Code + Obsidian.
四层架构：MCP server + unified query adapters + auto-compile pipeline + Claude 驱动的 agent scheduler。

Highlights

• 21 个 vault.* MCP 方法（search / read / write / graph / lint 等）
• Filesystem fallback -- Obsidian 不开也能正常工作
• 统一查询：memU + GitNexus + vault 三路加权融合
• 自动编译管线：脏队列 + 批处理
• 198 个对抗性测试（51 FS 渗透 + 48 WS 攻击 + 41 fuzzing + 58 E2E）
• 24 个 bug 在硬化期被发现并修复（路径穿越、HTTP 死锁、CLOSE_WAIT、timing-safe auth、CRLF、BOM、原子写等）
• 一键安装脚本 setup.sh
• 9 个捆绑 skill：vault-save / vault-world / vault-challenge / vault-emerge / vault-connect / vault-graduate / vault-ingest / vault-health / vault-reconcile

Quick Start

git clone <repo-url>
cd vault-mind
bash setup.sh

之后在 Claude Code 中重启会话，输入 /vault-world 开始使用。详见 README.md。

Known Limitations

• 并发 create 存在 TOCTOU 竞争（Obsidian API 限制，需 per-path mutex）
• Linux symlink 遍历尚未加固（目前主要在 Windows 上验证）
• dreamtime 集成在 CLAUDE.md 中有描述，核心代码尚未实现

Credits

• 作者：Curry
• AI 合作伙伴：Claude Code（主力）、Codex、Gemini 4
• 设计哲学：矛盾论 + 实践论 + 群众路线 + 马克思政治经济学
• 开发周期：2026-04-05 立项 -- 2026-04-08 v1.0 完成

v0.1.0 -- Obsidian LLM Wiki

First release. Karpathy's LLM Wiki concept, installable as an Obsidian plugin.

Quick Start

git clone https://github.com/2233admin/obsidian-llm-wiki.git
cd obsidian-llm-wiki && npm install && npm run build
node setup.js

Or download main.js, manifest.json, styles.css below and copy to .obsidian/plugins/llm-wiki/.

Highlights

• 20 MCP tools: read, search, graph, backlinks, batch, lint, init
• Works without Obsidian (filesystem fallback)
• Dry-run by default -- your notes are safe
• Knowledge compilation pipeline (ingest -> compile -> wiki)
• Security hardened: path traversal blocked, timing-safe auth, ReDoS guard, connection limits

Supported Agents

Claude Code, Claude Desktop, Cursor, Windsurf, and any MCP-compatible tool.