Files-first + Git-first 的开源 Markdown 知识库桌面应用，专为 AI Agent 上下文管理设计，支持 Claude Code/Codex/Gemini CLI，AGPL-3.0，13.9k stars。
定位
Tolaria 由 Luca Rossi（Refactoring.fm 作者）构建并每天使用，管理自己 10,000+ 笔记的个人 Second Brain。核心设计原则是零锁定：所有笔记都是普通 Markdown 文件，Vault 即 Git 仓库，离线完全可用。
典型用途：
- 个人第二大脑 / 个人知识管理
- 公司文档作为 AI 上下文
- 存储 OpenClaw/AI Agent 的 Memory 和操作流程
核心设计原则
- Files-first：笔记是纯 Markdown 文件，可移植，可用任意编辑器打开
- Git-first：每个 Vault 都是 Git 仓库，完整版本历史，支持任意 Git remote
- Offline-first：无账号、无订阅、无云依赖，永远离线可用
- AI-first but not AI-only：内置 AGENTS 文件，官方支持 Claude Code / Codex CLI / Gemini CLI 集成路径，也支持任意 AI
- Standards-based：Markdown + YAML frontmatter，无私有格式
- Keyboard-first：为 power-user 优化，Command Palette + 键盘驱动
- Types as lenses：类型只是导航辅助，非强制 Schema
安装
# macOS Homebrew
brew install --cask tolaria
# 或从 Release 页面下载 macOS/Windows/Linux 安装包
# https://refactoringhq.github.io/tolaria/download/Windows 安装包有 Authenticode 签名。
技术栈
- 框架：Tauri 2 + React + TypeScript
- 开发依赖：Node.js 20+，pnpm 8+，Rust stable
- 平台：macOS / Windows / Linux
# 本地开发
pnpm install
pnpm dev # 浏览器 mock 模式
pnpm tauri dev # 原生桌面 app内置 MCP Server（Linux 上依赖系统 node）。
与同类工具对比
| 维度 | Tolaria | Obsidian | llm-wiki-pattern |
|---|---|---|---|
| 开源 | 是（AGPL-3.0） | 核心闭源 | 纯工作流模式 |
| 文件格式 | 标准 Markdown | Markdown（插件私有格式） | 标准 Markdown |
| 同步 | Git remote | Obsidian Sync（付费） | 自行管理 |
| AI 集成 | 内置 AGENTS 文件 | 插件生态 | 原生 LLM 工作流 |
| 锁定风险 | 无 | 中等 | 无 |
AI Agent 集成
Vault 根目录内置 AGENTS 文件，让 AI Agent 自动理解 Vault 结构和约定，无需额外说明。官方支持：
- Claude Code
- Codex CLI
- Gemini CLI
这与 openhuman 中的 Obsidian Wiki 集成方向类似，但 Tolaria 更轻量且原生 Git。
Getting Started Vault
首次启动可克隆官方示例 Vault：https://github.com/refactoringhq/tolaria-getting-started
资源
- GitHub：https://github.com/refactoringhq/tolaria
- 官网：https://tolaria.md
- 架构文档：docs/ARCHITECTURE.md（仓库内）
- 作者 Twitter：https://x.com/lucaronin