tolaria README

The project's README from github.com/refactoringhq/tolaria. As one markdown file: README.md.

Latest stable Codecov CodeScene Hotspot Code Health Codacy Badge

💧 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:

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.

1776506856823-CleanShot_2026-04-18_at_12 06 57_2x

Sponsors

Tolaria is supported by a small panel of tools that help keep the project healthy, tested, and ready for AI-assisted development. I use these tools every day.

Codacy CodeScene CircleCI Unblocked

Walkthroughs

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

Principles

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.

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.

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 👇

Prerequisites

Linux system dependencies

Tauri 2 on Linux requires WebKit2GTK 4.1 and GTK 3:

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.

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

Tech Docs

Security

If you believe you have found a security issue, please report it privately as described in 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 (refactoringhq/tolaria)

Searching Database…

20.1K ·GitHub
What is this?Tolaria is a desktop app for macOS, Windows, and Linux that manages markdown knowledge bases — personal second brains, company docs, or AI assistant memory — stored as plain files in a git repo.
Is this a cloud note app or does it just manage local files?Tolaria is files-first and git-first: every vault is a folder of plain markdown files with YAML frontmatter, backed by a git repo for full version history, with no proprietary format and no cloud lock-in.
Is the Windows installer ready to use right now?The Windows installer is Authenticode-signed, but on company-managed machines IT may still need to approve the Tolaria publisher before the first install completes.
Does Tolaria need an internet connection or an account to work?No — there are no accounts or subscriptions, and a vault works completely offline; if you stop using Tolaria, you lose nothing since your data is just markdown files.
Which AI coding agents does Tolaria support?Tolaria ships setup paths for Claude Code, Codex CLI, and Gemini CLI, provides an AGENTS file so any agent can understand the vault, and bundles an MCP server to expose the vault to AI tooling.
Does Tolaria force notes into fixed templates or required fields?No — types in Tolaria are navigation aids rather than enforced schemas, so there are no required fields or validation, just helpful categories for finding notes.
Why did the author build Tolaria?Creator Luca built it to run his own workspace of 10,000+ notes combining his Refactoring work and personal journaling, using it daily as a second brain.
Is Tolaria built for mouse or keyboard use?It's designed keyboard-first for power users, with the Editor and Command Palette built around keyboard navigation.
Size
105.4 MB
Stars
20.1K
Age
8mo
Commits · 90 Days