- obsidian-mind là vault template Obsidian giúp Claude Code, Codex CLI và Gemini CLI nhớ context xuyên session - không cần giải thích lại từ đầu.
- Tiết kiệm khoảng 40% chi phí API: 30-50k tokens/session thay vì 70-80k khi rebuild context từ zero.
- Bộ 18 slash command, 9 subagent chuyên biệt và 5 lifecycle hook tự động phân loại, lưu notes đúng chỗ.
- MIT license, 2.2k stars trên GitHub, v6.0 ra tháng 4/2026.
TL;DR
obsidian-mind là một Obsidian vault template do Brenno Ferrari (Senior iOS Engineer tại Berlin) tạo ra, biến vault markdown local của bạn thành bộ nhớ dài hạn cho Claude Code - và cả Codex CLI, Gemini CLI. Thay vì mỗi session phải giải thích lại project, architecture decisions, hay team dynamics, Claude đọc thẳng từ vault, ghi notes đúng chỗ, và tích lũy context qua từng buổi. v6.0 vừa ra cuối tháng 4/2026, hiện có 2.2k stars trên GitHub. MIT license, cài bằng một lệnh.
Vấn Đề Mọi Người Dùng Claude Code Đều Biết
Claude Code rất mạnh, nhưng stateless theo định nghĩa. Mỗi session mới là một tờ giấy trắng - không có context về project bạn làm 3 tuần qua, không nhớ architectural decision từ hôm qua, không biết tone giọng bạn muốn dùng khi viết code review. Kết quả: bạn giải thích đi giải thích lại cùng một thứ, tốn token và tốn thời gian.
Workaround phổ biến nhất là file CLAUDE.md - nhưng file này phình to dần, khó maintain, và nếu không update trước mỗi session thì Claude đọc context cũ, phản hồi calibrate sai. Session context window reset khi đóng, kiến thức không compound.
obsidian-mind giải quyết đúng điểm này: vault Obsidian chỉ là một folder markdown trên disk của bạn. Claude Code đọc file text natively - không cần plugin, không cần API đặc biệt. Mọi note bạn viết, mọi quyết định Claude ghi lại, đều tích lũy và có thể truy xuất ở session tiếp theo.
Dưới Nắp Capô: 5 Hooks Chạy Tự Động
Điểm cốt lõi của obsidian-mind không phải là vault structure, mà là 5 lifecycle hook TypeScript chạy deterministic - không cần LLM call thêm, chạy local qua Node 22+ LTS:
- SessionStart - Inject North Star goals, active projects, recent changes, open tasks và full file listing vào đầu mỗi session (~2K tokens). Claude bắt đầu với đầy đủ context, không phải blank slate.
- UserPromptSubmit - Phân loại mỗi tin nhắn của bạn (decision, incident, win, 1:1, architecture, person update...) và inject routing hint (~100 tokens/message). AI biết note này nên lưu vào đâu.
- PostToolUse - Sau mỗi lần ghi file, tự validate frontmatter và kiểm tra wikilinks (~200 tokens).
- PreCompact - Backup session transcript trước khi context compaction.
- Stop - Checklist cuối session: archive completed projects, update indexes, check orphans.
Nhờ tiered loading thay vì dump cả vault vào context, mức tiêu thụ token điển hình chỉ 30-50k tokens/session - so với 70-80k khi rebuild context từ đầu. Tiết kiệm khoảng 40% chi phí API.
Kho Vũ Khí: 18 Command + 9 Subagent
obsidian-mind đi kèm 18 slash command sẵn dùng trong Claude Code, Codex CLI và Gemini CLI:
- /om-standup - Khởi động buổi sáng: load context hôm qua, surface tasks, gợi ý ưu tiên
- /om-dump - Capture bất kỳ suy nghĩ nào, hook tự route đúng chỗ
- /om-wrap-up - Tổng kết session: verify notes, update indexes, phát hiện wins chưa ghi
- /om-review-brief - Tổng hợp toàn bộ evidence (brag doc, decisions, incidents, competency) thành brief review đầy đủ
- /om-peer-scan - Deep-scan GitHub PRs của đồng nghiệp, ghi structured evidence cho review mùa
- /om-incident-capture - Capture incident từ Slack/channels thành structured notes với timeline, root cause, impact
- /om-vault-upgrade - Migrate từ vault cũ hoặc vault bất kỳ vào template mới, không mất content
9 subagent chuyên biệt chạy trong isolated context window để không làm đục context chính: slack-archaeologist reconstruct toàn bộ Slack thread, vault-librarian fix orphan links và stale notes, review-fact-checker verify từng claim trong draft review trước khi submit.
Tìm Kiếm Theo Nghĩa Với QMD
Nếu cài thêm QMD (optional), obsidian-mind mở ra semantic search native qua MCP - Claude có thêm tool mcp__qmd__query, mcp__qmd__get ngay trong tool menu, ngang hàng với Read và Edit.
Thay vì grep literal, QMD hiểu ngữ nghĩa: hỏi "chúng ta quyết định gì về caching" - nó tìm được note "Redis Migration ADR" dù không match keyword. Lần đầu dùng cần tải ~328MB embedding model; nếu bật LLM reranking thêm ~1.28GB. Không có QMD? Vault vẫn chạy bình thường, fallback về grep + Obsidian CLI.
So Sánh Thực Tế
| Approach | Token/session | Mid-session recall | Tự động hóa |
|---|---|---|---|
| Stateless default | 70-80k | Không | Không |
| Manual vault + CLAUDE.md | Phụ thuộc file size | Grep thủ công | Phải tự update 5 phút/session |
| Python hook + Anthropic API | Thêm API call để extract | Kém với vault lớn | Chỉ Stop hook |
| obsidian-mind | 30-50k (-40%) | QMD semantic + MCP | 5 hooks, deterministic local |
Điểm khác biệt lớn nhất so với approach Python hook của MindStudio: obsidian-mind dùng TypeScript hooks chạy local, không cần thêm LLM call để extract insights, và có UserPromptSubmit hook phân loại mid-session thay vì chỉ xử lý đầu/cuối.
Giới Hạn Cần Biết
- Context window ceiling: Vault hàng nghìn notes thì Claude không đọc hết - cần scope explicit path, tránh vault-wide sweep.
- CLAUDE.md drift: Nếu không update Active Context section trước session, AI đọc context cũ và phản hồi sai. ~5 phút maintain mỗi session là đủ.
- Hallucination khi synthesis: Luôn prompt với ràng buộc "chỉ dùng những gì tôi đã viết" khi yêu cầu tổng hợp, không để model interpolate từ training data.
- Không thay thế được CRM/transactional DB: Obsidian + Claude Code rất tốt cho knowledge cá nhân và text-based tracking, nhưng không phải tool cho 500 clients với sales pipeline và invoicing.
- Agent không tự ghi file: Intentional - bảo vệ vault của bạn. Mọi write phải từ explicit instruction.
Ai Nên Dùng và Cài Như Thế Nào
obsidian-mind phù hợp với engineers và managers đang dùng Obsidian và muốn Claude Code thực sự nhớ việc giữa các session - đặc biệt ai làm multi-week projects, track performance reviews, hoặc xử lý incidents thường xuyên.
Cài nhanh qua ShardMind CLI:
mkdir my-vault && cd my-vault
npx shardmind installWizard hỏi tên, tổ chức, mục tiêu vault và có enable QMD không. Sau đó mở folder bằng Obsidian, enable Obsidian CLI (Settings > General, cần Obsidian 1.12+), rồi chạy claude trong thư mục vault là xong.
Timeline thực tế: 2 ngày để setup scaffolding, 3 tháng để vault đạt độ chín với patterns tự nhiên, từ tháng 6 trở đi là multiplier - mỗi project mới bắt đầu với toàn bộ context của những project trước.
