whatisgithub

What is tolaria?

refactoringhq/tolaria — explained in plain English

Analysis updated 2026-06-24

10,564TypeScriptAudience · writerComplexity · 1/5Setup · easy

In one sentence

Tolaria is a free offline desktop app for macOS, Windows, and Linux that stores your notes as plain markdown files in a git repository, giving you full edit history and sync to any git host with no subscription required.

Mindmap

mindmap
  root((tolaria))
    What it does
      Note management
      Plain markdown files
      Full edit history
    Features
      Git-backed vault
      Works offline
      AI tool friendly
    Use Cases
      Personal knowledge base
      Cross-device sync
      AI-assisted notes
    Install
      Homebrew macOS
      Download release
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep a personal knowledge base of thousands of notes as plain markdown files with full version history and no cloud subscription

USE CASE 2

Sync your note vault to GitHub or any git host for backup and access across multiple devices

USE CASE 3

Use AI tools like Claude Code directly on your vault because it is stored as plain files on your computer

USE CASE 4

Browse and search a large collection of markdown notes with a desktop app that works completely offline

What is it built with?

TypeScriptReactTauri

How does it compare?

refactoringhq/tolariacuixiaorui/mini-vuemail-0/zero
Stars10,56410,57910,548
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasyhard
Complexity1/52/54/5
Audiencewriterdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

So what is it?

Tolaria is a free, open source desktop app for macOS, Windows, and Linux that helps you manage a personal knowledge base made up of plain markdown files. You store notes as regular files on your computer, organized however you like, and Tolaria gives you an interface to browse, edit, and search them. Because the notes are just files, they work with any other text editor too, and you can take them with you if you ever stop using Tolaria. Every collection of notes, called a vault, is stored as a git repository. This means you get a full history of every change you have ever made, and you can sync your vault to any git hosting service you already use, without creating an account with Tolaria or paying a subscription. The app works completely offline and keeps no data on external servers. Tolaria is designed to work well with AI tools. The vault format is a folder of plain files, which is something AI coding assistants like Claude Code or Gemini CLI can read and work with directly. The app includes setup paths for several of those tools, and provides a file called AGENTS so that any AI assistant can understand the structure of your vault. You are free to use whatever AI tool you prefer. The app is built with Tauri, React, and TypeScript, and is installed either through Homebrew on macOS or by downloading a release from the project website. A getting-started vault is available to clone when you first open the app, and it walks you through the main features. User documentation lives in the repository and is published as a website through GitHub Pages. Types in Tolaria are categories you can assign to notes to help you find them more easily. They are navigation shortcuts rather than strict rules, so there are no required fields and no validation errors if you do not follow a particular structure. The project was built by its creator to manage a personal workspace of more than 10,000 notes and is shared publicly for others to use.

Copy-paste prompts

Prompt 1
How do I install Tolaria and create my first vault from the getting-started template to manage my personal notes?
Prompt 2
Show me how to sync a Tolaria vault to a private GitHub repository so my notes are backed up and accessible on another computer.
Prompt 3
How can I use Claude Code with a Tolaria vault to search my notes or add content using AI tools?
Prompt 4
Explain how Types in Tolaria work and how I can use them to organize a large collection of notes more easily.

Frequently asked questions

What is tolaria?

Tolaria is a free offline desktop app for macOS, Windows, and Linux that stores your notes as plain markdown files in a git repository, giving you full edit history and sync to any git host with no subscription required.

What language is tolaria written in?

Mainly TypeScript. The stack also includes TypeScript, React, Tauri.

How hard is tolaria to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is tolaria for?

Mainly writer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.