Tolaria Quản lý knowledge base bằng Markdown như dân chuyên nghiệp

Bạn có bao nhiêu notes nằm rải rác giữa Notion, Google Docs, file .md random trong máy, và vài cái sticky note trên desktop? Mình từng như vậy. Và cái cảm giác "mình biết mình đã ghi cái này ở đâu đó" rồi tìm không ra nó frustrating kinh khủng.

Rồi mình tìm được Tolaria.

Tolaria là gì?

Tolaria là một desktop app (chạy trên macOS, Windows, Linux) dùng để quản lý markdown knowledge bases. Nói đơn giản: bạn có một folder chứa các file .md, và Tolaria biến folder đó thành một workspace có tổ chức, dễ navigate, dễ search.

Nhưng khác với Obsidian hay Notion, Tolaria đi theo một triết lý rất rõ ràng: files-first, git-first, offline-first. Không account, không subscription, không cloud dependency. Vault của bạn là một git repo. Notes của bạn là plain markdown với YAML frontmatter. Hết.

Project này được tạo bởi Luca (founder của Refactoring), và anh ấy dùng nó để quản lý 10,000+ notes cá nhân. Repo trên GitHub đã có hơn 10.5k stars con số không nhỏ cho một tool trong niche này.

Tại sao mình quan tâm đến Tolaria

Theo kinh nghiệm của mình, vấn đề lớn nhất với các knowledge management tool không phải là feature mà là lock-in. Bạn đổ hàng nghìn giờ ghi chép vào một platform, rồi một ngày nó tăng giá, thay đổi policy, hoặc đơn giản là shutdown. Lúc đó export data ra thì format nát bét, link nội bộ bay hết.

Tolaria giải quyết vấn đề này từ gốc:

• Notes là file markdown — bạn mở được bằng bất kỳ text editor nào
• Vault là git repo — version history miễn phí, sync qua bất kỳ git remote nào (GitHub, GitLab, self-hosted)
• Không có proprietary format — nếu bạn bỏ Tolaria ngày mai, bạn không mất gì cả

Điều mình thấy hay là cái mindset "zero lock-in" này không phải chỉ là marketing. Khi nhìn vào codebase (AGPL-3.0 license), bạn thấy rõ nó được design để data luôn portable.

Ai nên dùng Tolaria?

Từ README và cách community đang sử dụng, có vài use case nổi bật:

Second brain / Personal knowledge management

Nếu bạn theo phương pháp Zettelkasten, PARA, hay đơn giản là thích ghi chép mọi thứ Tolaria là một lựa chọn solid. Markdown + YAML frontmatter cho phép bạn structure notes theo cách mình muốn mà không bị ép vào một template cứng nhắc.

Company docs làm context cho AI

Đây là use case mình thấy cực kỳ thú vị. Bạn organize documentation của team/company trong Tolaria, rồi dùng nó làm knowledge base cho AI assistants. Repo có cả folder mcp-server — nghĩa là nó hỗ trợ Model Context Protocol, cho phép AI tools kết nối trực tiếp vào vault của bạn.

Tưởng tượng bạn có một bộ docs về coding standards, architecture decisions, runbooks của team. Thay vì paste manual vào ChatGPT mỗi lần, bạn cho AI agent đọc trực tiếp từ vault. Game changer.

OpenClaw/assistants memory

Nếu bạn đang build AI assistants và cần một nơi lưu trữ procedures, memory Tolaria hoạt động như một structured storage layer mà bạn control hoàn toàn.

Những điểm đáng chú ý trong kiến trúc

Nhìn vào repo structure, có vài thứ mình muốn highlight:

Tauri-based desktop app (src-tauri): Thay vì dùng Electron (nặng, tốn RAM), Tolaria chọn Tauri framework viết desktop app bằng Rust backend + web frontend. Kết quả là app nhẹ hơn đáng kể, performance tốt hơn, và memory footprint thấp hơn nhiều so với các Electron app cùng loại.

MCP Server tích hợp (mcp-server): Đây là điểm khác biệt lớn so với Obsidian. Việc có sẵn MCP server nghĩa là bạn có thể kết nối Claude, GPT, hay bất kỳ AI agent nào hỗ trợ MCP vào vault của mình. Không cần plugin third-party, không cần hack.

Types as lenses, not schemas: Triết lý này rất hay. Trong Tolaria, "types" chỉ là cách bạn nhìn (filter/navigate) notes không phải schema bắt buộc. Không có required fields, không có validation rules cứng. Bạn muốn một note vừa là "meeting note" vừa là "project doc"? Thoải mái. Approach này flexible hơn nhiều so với kiểu database-first của Notion.

E2E testing setup (e2e, playwright.config.ts): Mình thích việc project này có Playwright tests cho cả smoke, integration, và e2e. Với một desktop app, việc maintain test suite như vậy cho thấy team nghiêm túc về quality.

So sánh nhanh với Obsidian

Câu hỏi hiển nhiên: "Khác gì Obsidian?"

• Obsidian cũng dùng markdown, cũng local-first, nhưng có hệ sinh thái plugin khổng lồ và community lớn hơn nhiều. Sync phải trả tiền hoặc tự setup.
• Tolaria đi sâu hơn vào git-first (vault = git repo by default), có MCP server tích hợp sẵn, và hoàn toàn open source (AGPL-3.0). Obsidian thì source-available nhưng không phải open source.

Theo mình, nếu bạn cần plugin ecosystem phong phú và community support lớn Obsidian vẫn là lựa chọn an toàn. Nhưng nếu bạn là developer, thích git workflow, muốn tích hợp AI qua MCP, và quan tâm đến open source Tolaria đáng để thử.

Cách bắt đầu

Cách nhanh nhất:

1. Clone repo: git clone https://github.com/refactoringhq/tolaria
2. Cài dependencies: pnpm install
3. Chạy dev: theo hướng dẫn trong CONTRIBUTING.md

Hoặc đơn giản hơn, download bản build sẵn từ releases page.

Repo có sẵn demo-vault-v2 để bạn explore trước khi tạo vault riêng. Mình khuyên bạn nên xem mấy cái Loom walkthrough mà Luca record ngắn gọn, đi thẳng vào vấn đề.

Vài điều mình rút ra

Git-first là tương lai của personal knowledge management. Không phải vì git dễ dùng (nó không dễ với non-developers), mà vì nó giải quyết triệt để bài toán version history, sync, và backup mà không cần trust bất kỳ cloud service nào.

MCP integration sẽ trở thành table stakes. Trong 1-2 năm tới, bất kỳ knowledge management tool nào không hỗ trợ AI agents đọc trực tiếp data sẽ bị bỏ lại phía sau. Tolaria đi trước ở điểm này.

Open source matters. Với một tool mà bạn đổ cả cuộc đời notes vào, việc biết chắc rằng code là open, data là portable, và không ai có thể lock bạn lại đó không phải nice-to-have, đó là requirement.

Nếu bạn đang tìm một nơi để xây dựng second brain mà không lo bị lock-in, hoặc cần một knowledge base có thể feed trực tiếp cho AI give Tolaria a try. Với 10.5k stars và 2,530 commits, đây không phải side project bỏ dở. Đây là tool mà người tạo ra nó dùng hàng ngày với 10,000+ notes. Và đôi khi, đó là signal tốt nhất bạn cần.