refactoringhq / tolaria

查看原文 / View Original 编辑 / Edit

refactoringhq / tolaria

💧 Tolaria is a desktop app for macOS, Windows, and Linux for managing markdown knowledge bases. People use it for a variety of use cases: Operate second brains and personal knowledge, organize company docs as context for AI, and store OpenClaw/assistants memory and procedures. Personally, I use it to run my life (hey 👋 Luca here). I have a massive workspace of 10,000+ notes, which are the result of my Refactoring work + a ton of personal journaling and second braining.

💧 Tolaria 是一款适用于 macOS、Windows 和 Linux 的桌面应用程序，用于管理 Markdown 知识库。人们将其用于多种场景：运营“第二大脑”和个人知识库、整理公司文档作为 AI 的上下文，以及存储 OpenClaw/AI 助手的记忆与流程。就我个人而言，我用它来管理我的生活（嘿 👋 我是 Luca）。我拥有一个包含超过 10,000 条笔记的庞大工作区，这些笔记是我 Refactoring 工作以及大量个人日记和“第二大脑”实践的结晶。

Walkthroughs

You can find some Loom walkthroughs below — they are short and to the point:

  • How I Organize My Own Tolaria Workspace
  • My Inbox Workflow
  • How I Save Web Resources to Tolaria

视频演示

你可以在下方找到一些 Loom 视频演示——它们简短且直击重点：

  • 我是如何组织自己的 Tolaria 工作区的
  • 我的收件箱工作流
  • 我是如何将网络资源保存到 Tolaria 的

Principles

📑 Files-first — Your notes are plain markdown files. They’re portable, work with any editor, and require no export step. Your data belongs to you, not to any app.

设计原则

📑 文件优先 — 你的笔记就是纯 Markdown 文件。它们具有可移植性，适用于任何编辑器，且无需导出步骤。你的数据属于你，而不是任何应用程序。

🔌 Git-first — Every vault is a git repository. You get full version history, the ability to use any git remote, and zero dependency on Tolaria servers.

🔌 Git 优先 — 每个知识库（Vault）都是一个 Git 仓库。你可以获得完整的版本历史记录，能够使用任何 Git 远程仓库，并且完全不依赖 Tolaria 服务器。

🛜 Offline-first, zero lock-in — No accounts, no subscriptions, no cloud dependencies. Your vault works completely offline and always will. If you stop using Tolaria, you lose nothing.

🛜 离线优先，零绑定 — 无需账户、无需订阅、无需云端依赖。你的知识库完全离线运行，且永远如此。如果你停止使用 Tolaria，你不会丢失任何东西。

🔬 Open source — Tolaria is free and open source. I built this for myself and for sharing it with others.

🔬 开源 — Tolaria 是免费且开源的。我构建它是为了自己使用，并与他人分享。

📋 Standards-based — Notes are markdown files with YAML frontmatter. No proprietary formats, no locked-in data. Everything works with standard tools if you decide to move away from Tolaria.

📋 基于标准 — 笔记是带有 YAML 元数据的 Markdown 文件。没有专有格式，没有数据锁定。如果你决定弃用 Tolaria，所有内容依然可以使用标准工具处理。

🔍 Types as lenses, not schemas — Types in Tolaria are navigation aids, not enforcement mechanisms. There’s no required fields, no validation, just helpful categories for finding notes.

🔍 类型即视角，而非模式 — Tolaria 中的“类型”是导航辅助工具，而非强制机制。没有必填字段，没有验证，只有用于查找笔记的实用分类。

🪄 AI-first but not AI-only — A vault of files works very well with AI agents, but you are free to use whatever you want. We support Claude Code, Codex CLI, and Gemini CLI setup paths, but you can edit the vault with any AI you want. We provide an AGENTS file for your agents to figure out.

🪄 AI 优先但非 AI 独占 — 文件库与 AI 智能体配合得非常好，但你可以自由使用任何你想要的工具。我们支持 Claude Code、Codex CLI 和 Gemini CLI 的设置路径，但你可以用任何你喜欢的 AI 编辑知识库。我们提供了一个 AGENTS 文件供你的智能体读取。

⌨️ Keyboard-first — Tolaria is designed for power-users who want to use keyboard as much as possible. A lot of how we designed the Editor and the Command Palette is based on this.

⌨️ 键盘优先 — Tolaria 专为希望尽可能多地使用键盘的高级用户设计。编辑器和命令面板的许多设计都基于此理念。

💪 Built from real use — Tolaria was created for manage my personal vault of 10,000+ notes, and I use it every day. Every feature exists because it solved a real problem.

💪 源于真实使用 — Tolaria 的诞生是为了管理我个人超过 10,000 条笔记的知识库，我每天都在使用它。每一个功能的出现都是为了解决实际问题。

Installation

Homebrew Install via Homebrew on macOS: brew install --cask tolaria

Download from releases Download the latest release here for macOS, Windows, or Linux. Windows installers are Authenticode-signed; company-managed devices may still require IT approval of the Tolaria publisher before first install.

安装

Homebrew 在 macOS 上通过 Homebrew 安装： brew install --cask tolaria

从发布页面下载 点击此处下载 macOS、Windows 或 Linux 的最新版本。Windows 安装程序已进行 Authenticode 签名；公司管理的设备在首次安装前可能仍需 IT 部门批准 Tolaria 发布者。

Getting started

When you open Tolaria for the first time you get the chance of cloning the getting started vault — which gives you a walkthrough of the whole app. The public user docs live in site/ and are published to GitHub Pages. Start with Install Tolaria, then First Launch.

入门指南

当你第一次打开 Tolaria 时，你可以选择克隆“入门知识库”（getting started vault），它会带你浏览整个应用程序。公开的用户文档位于 site/ 目录下，并发布在 GitHub Pages 上。请从“安装 Tolaria”开始，然后进行“首次启动”。

Open source and local setup

Tolaria is open source and built with Tauri, React, and TypeScript. If you want to run or contribute to the app locally, here is how to get started. You can also find the gist below 👇

开源与本地开发设置

Tolaria 是开源的，使用 Tauri、React 和 TypeScript 构建。如果你想在本地运行或为该应用做出贡献，请参考以下入门指南。你也可以在下方找到要点 👇

Prerequisites

  • Node.js 20+
  • pnpm 8+
  • Rust stable
  • macOS or Linux for development

前置要求

  • Node.js 20+
  • pnpm 8+
  • Rust 稳定版
  • 开发环境需 macOS 或 Linux

Linux system dependencies Tauri 2 on Linux requires WebKit2GTK 4.1 and GTK 3:

  • Arch / Manjaro: sudo pacman -S --needed webkit2gtk-4.1 base-devel curl wget file openssl appmenu-gtk-module libappindicator-gtk3 librsvg
  • Debian / Ubuntu (22.04+): sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev libsoup-3.0-dev patchelf
  • Fedora 38+: sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file libappindicator-gtk3-devel librsvg2-devel

The bundled MCP server still spawns the system node binary at runtime on Linux, so install Node from your distro package manager if you want the external AI tooling flow.

Linux 系统依赖 Linux 上的 Tauri 2 需要 WebKit2GTK 4.1 和 GTK 3：

  • Arch / Manjaro: sudo pacman -S --needed webkit2gtk-4.1 base-devel curl wget file openssl appmenu-gtk-module libappindicator-gtk3 librsvg
  • Debian / Ubuntu (22.04+): sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev libsoup-3.0-dev patchelf
  • Fedora 38+: sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file libappindicator-gtk3-devel librsvg2-devel

捆绑的 MCP 服务器在 Linux 运行时仍会调用系统 Node 二进制文件，因此如果你需要外部 AI 工具流，请通过发行版的包管理器安装 Node。

Quick start

pnpm install
pnpm dev

Open http://localhost:5173 for the browser-based mock mode, or run the native desktop app with: pnpm tauri dev

快速启动

pnpm install
pnpm dev

访问 http://localhost:5173 进入基于浏览器的模拟模式，或运行原生桌面应用： pnpm tauri dev

Tech Docs

  • 📐 ARCHITECTURE.md — System design, tech stack, data flow
  • 🧩 ABSTRACTIONS.md — Core abstractions and models
  • 🚀 GETTING-STARTED.md — How to navigate the codebase
  • 📚 ADRs — Architecture Decision Records

技术文档

  • 📐 ARCHITECTURE.md — 系统设计、技术栈、数据流
  • 🧩 ABSTRACTIONS.md — 核心抽象与模型
  • 🚀 GETTING-STARTED.md — 如何浏览代码库
  • 📚 ADRs — 架构决策记录

Security

If you believe you have found a security issue, please report it privately as described in SECURITY.md.

安全性

如果你认为发现了安全问题，请按照 SECURITY.md 中的说明私下报告。

License

Tolaria is licensed under AGPL-3.0-or-later. The Tolaria name and logo remain covered by the project’s trademark policy.

许可证

Tolaria 采用 AGPL-3.0-or-later 许可证。Tolaria 的名称和徽标仍受项目商标政策保护。

← 返回新闻列表 / Back to news list