refactoringhq / tolaria

#10

12,273872+420 todayTypeScript

View on GitHub

Desktop app to manage markdown knowledge bases

💡 Use Cases

最适合需要离线优先、数据自主、Git版本控制的个人知识管理和AI上下文文档库场景

个人第二大脑

Problem: 笔记分散在多个App，数据不归自己所有，迁移困难

Solution: 所有笔记存为纯Markdown文件，每个知识库是一个Git仓库，离线可用，无需账户，数据完全自主可控

Example: 日常记录想法、读书笔记、项目复盘，10,000+笔记的巨型工作空间，通过YAML类型灵活分类，无需强制模式

AI上下文文档库

Problem: 团队文档散乱，难以作为AI助手的上下文输入，且需频繁同步

Solution: 将公司文档整理为Markdown文件并纳入Git仓库，Tolaria提供AGENTS文件让AI代理自动理解知识库结构，支持Claude Code、Codex CLI等AI工具直接读取

Example: 将产品文档、API手册、技术规范整理成Markdown，AI代理在回答问题时自动检索相关笔记作为上下文

收件箱工作流与网页剪藏

Problem: 临时想法和网页资源难以快速捕捉并归入知识库

Solution: 内置收件箱工作流，支持快速保存网页资源到Tolaria，后续再整理分类

Example: 浏览网页时一键保存文章到收件箱，周末集中整理到对应类型笔记中，避免信息丢失

📊 Project Info

Language: TypeScript
Stars: ⭐ 12,273
Forks: 872
Today: +420
Ranking: #10
Collection: Language
Trending Date: June 5, 2026
Last Push: 6/5/2026

🏷️ Topics

TypeScript桌面应用知识管理Markdown编辑器离线优先开源免费知识工作者个人用户

📸 Screenshots

5分钟快速开始 Tolaria

Tolaria 是一款跨平台桌面应用，用于管理 Markdown 知识库，采用文件优先和 Git 优先原则，数据完全归你所有。

🖥️ OS

macOSWindowsLinux

⚙️ Runtime

Node.js20+

pnpm8+

Ruststable

🔧 Tools

Git— 克隆仓库和版本控制

📝 Steps

克隆仓库

克隆 Tolaria 仓库到本地。

克隆仓库

$ git clone https://github.com/refactoringhq/tolaria.git

进入项目目录

$ cd toloria

✓Expected: 成功克隆并进入 toloria 目录。

💡确保已安装 Git。

安装依赖

使用 pnpm 安装项目依赖。

安装所有依赖

$ pnpm install

✓Expected: 依赖安装完成，无错误。

💡如果 pnpm 未安装，先运行 npm install -g pnpm。

启动开发模式

启动浏览器模拟模式，快速预览应用。

启动开发服务器

$ pnpm dev

✓Expected: 终端显示 http://localhost:5173 可访问。

💡首次启动可能需要一些时间编译。

打开应用

在浏览器中打开 Tolaria。

✓Expected: 浏览器中显示 Tolaria 界面，可创建或克隆知识库。

💡如果使用原生桌面应用，可运行 pnpm tauri dev。

✅ 验证成功

在浏览器中看到 Tolaria 主界面，并可以创建新知识库或克隆入门知识库。

✓浏览器显示 Tolaria 界面
✓可以创建或打开知识库

⚡ Quick Tips

开发使用 pnpm dev 启动浏览器模式，无需安装 Tauri 依赖。

使用首次启动时选择克隆入门知识库，快速了解功能。

🔍 Troubleshooting

❓ pnpm install 失败

→ 确保 Node.js 版本 >=20，pnpm 版本 >=8，并检查网络连接。

❓ 启动后页面空白

→ 检查终端是否有错误，尝试重新运行 pnpm install 和 pnpm dev。

🎯 Next Steps

探索入门知识库

克隆入门知识库，了解 Tolaria 的核心功能和工作流。

创建自己的知识库

在本地创建一个 Git 仓库，作为你的第一个知识库。