Obsidian、Logseq 这类 Markdown 笔记用久了，知识都在本地文件夹里，可它和 AI 编程工具常常是分开的。想让 Claude Code 按某个主题整理笔记，得先复制粘贴；想让它把整理结果写回笔记库，更要绕一道。
tolaria 是一个桌面 Markdown 笔记应用，用 Tauri、React 和 TypeScript 写成，支持 macOS、Windows 和 Linux。它把每份笔记保持为磁盘上的 Markdown 文件，每个 vault 本身就是一个 git 仓库，并在仓库里放一份 Agent 能读懂的说明。GitHub 上目前超过 2 万 star（截至 2026 年 11 月），协议是 AGPL-3.0-or-later。
这篇讲它和常见笔记软件的差别、怎么安装，以及怎样把 vault 交给 Claude Code 这类工具使用。
先把它看成一个不会绑走数据的笔记库
打开 tolaria，布局并不陌生：左边文件树，右边编辑器，文件夹、标签、双向链接和命令面板都有，操作也偏向键盘。
它真正坚持的是几条底层约定。笔记永远是普通 Markdown 文件，不是私有数据库；每个 vault 都是 git 仓库，改动自带版本历史，也可以推到你自己的远程。官方还强调离线可用、不强制账户和订阅。哪天不用它了，文件夹拷走就能用别的编辑器打开，或继续让其他工具读取。
类型在 tolaria 里更像导航分类，而不是强制字段校验。标准是 Markdown 加 YAML frontmatter，不为了功能去造一份只有它自己认得的格式。
真正不一样的地方：给 Agent 留了入口
只靠“文件就是 Markdown、仓库就是 git”，还不能把它和许多现有工具完全分开。tolaria 多做的一步，是从一开始按“能和 AI 协作”来设计 vault。
vault 根目录会有一份 AGENTS.md，用来说明这个笔记库的结构、命名和约定。Claude Code、Codex CLI、Gemini CLI 读得懂这份文件。你可以直接让它们去库里查找某个主题、整理成草稿，或按约定写回新文件，而不必先把内容导出再导入。
官方的说法是：AI-first，但不是 AI-only。它为 Claude Code、Codex CLI 和 Gemini CLI 提供了设置路径，同时你仍然可以用任何编辑器或别的 Agent 去改这些文件。Linux 上如果要用到内置 MCP server 去对接外部 AI 工具流，系统里还需要有 Node，这一点官方安装说明里写过。
如果笔记仍然放在 Obsidian 里、只是希望 Claude Code 能进去工作，可以对照已经写过的Claudian 插件说明。那是给 Obsidian 加入口；tolaria 则是把 vault 直接做成 Agent 能读写的 git 仓库，两条路不一样。
怎么安装
macOS 上可以用 Homebrew：
brew install --cask tolaria
Windows 和 Linux 从官方下载页获取安装包：https://refactoringhq.github.io/tolaria/download/ 。Windows 安装包有 Authenticode 签名，公司管控的电脑可能仍要 IT 批准发布者。当前稳定版可以看 GitHub Releases，最近一次是 2026 年 11 月 10 日的 v2026-11-10。
第一次打开时，官方建议克隆 getting-started vault。里面是一份现成的走查，比直接啃文档更快进入状态。用户文档发布在项目站点，可从安装说明看起。
如果要参与开发或本地编译，官方要求 Node.js 20+、pnpm 8+ 和稳定版 Rust。Linux 还需要 WebKit2GTK 4.1 和 GTK 3，Ubuntu 需 22.04 或更新版本。一般使用直接下安装包即可，不必走这条路径。
移动端现在也有测试版
官方 README 已经写明：iPhone 和 iPad 上的 tolaria 正在通过 TestFlight 做测试。移动端提供所见即所得的 Markdown 编辑、保存时自动提交的 git 集成，并可通过 iCloud、文件应用与桌面端共用同一个 git 仓库。官方也提醒，移动端仍较早、还在活跃开发。测试邀请在 TestFlight。
使用前要知道的限制
协议是 AGPL-3.0-or-later，个人和团队内部使用通常没问题，但如果要把代码嵌进商业产品，需要先看条款。名称和 logo 另外受项目的商标政策约束。
它解决的是“笔记库怎样变成 Agent 可直接读写的本地仓库”，不是把 Obsidian 的全部插件生态搬过来。功能习惯如果绑在某个现有工具的插件上，迁移仍然要自己评估。
小结
tolaria 没有在笔记功能数量上和老工具硬比，而是把文件、git 和 AGENTS.md 缝在一起，让 Claude Code 这类工具能直接进入你的知识库。对同时重度使用笔记和 AI 编程工具的人，它提供的是一种很具体的工作方式：知识留在本地仓库里，Agent 按仓库里的约定读写。
若要在 Claude Code 或 Codex 里长期使用这类本地仓库工作流，也可以先看AIGoCode 使用指南。