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
• 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.

Two simple ideas drive Tolaria:

1. 📝 Simple text — your knowledge is just plain markdown files you own, readable and editable anywhere, with or without Tolaria.
2. 🔁 Simple sync — keeping those files on every device is just copying them to storage you control. No accounts, no servers, no version-control plumbing.

• Custom theme system — Users can define their own CSS variable themes, choose bundled theme presets, and keep light/dark styling local to their installation.
• Simple S3 sync (now the only sync) — Sync is a plain file copy to any S3-compatible provider (Cloudflare R2, MinIO, AWS S3, …), with status-bar controls and automatic startup, focus, interval, and close-time sync. Git sync was removed entirely — vaults are just folders of markdown, no repository or version-control setup required.
• Mobile support — Tolaria now includes Android and iOS app targets, bringing the same markdown vault model to mobile devices.

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

• 📝 Simple text, files-first — Every note is a plain markdown file with YAML frontmatter — nothing more. They're portable, work with any editor, need no export step, and stay readable without Tolaria. Your data is just text on your disk, and it belongs to you, not to any app.
• 🔁 Simple sync — Syncing a vault is just copying its files to S3-compatible storage you control (Cloudflare R2, MinIO, AWS S3, …). No accounts, no servers, no git or version-control setup — point Tolaria at a bucket and your vault follows you across devices. Conflicts keep both versions on disk, so nothing is ever lost.
• 🛜 Offline-first, zero lock-in — No accounts, no subscriptions, no required cloud. Your vault works completely offline and always will. If you stop using Tolaria, you keep every file and lose nothing.
• 🔬 Open source — Tolaria is free and open source. I built this for myself and for sharing it with others.
• 📋 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.
• 🔍 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.
• 🪄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, OpenCode, Pi, Gemini, and Kiro setup paths, but you can edit the vault with any AI you want. We provide an AGENTS file for your agents to figure out.
• ⌨️ 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.
• 💪 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.

Install via Homebrew on macOS:

brew install --cask tolaria

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.

When you open Tolaria for the first time you can create the built-in Getting Started vault — a bundled set of sample notes that walks you through the whole app. It's written straight to disk as plain markdown (no download, no clone, no network required).

The public user docs live in site/ and are published to GitHub Pages. Start with Install Tolaria, then First Launch.

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 👇

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

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.

pnpm install
pnpm dev

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

pnpm tauri dev

• 📐 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

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

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