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
Что это такое?Tolaria — это настольное приложение для macOS, Windows и Linux, которое управляет базами знаний в формате markdown: личными «вторыми мозгами», документацией компании или памятью ИИ-ассистентов. Всё хранится в виде обычных файлов в git-репозитории.
Это облачное приложение для заметок или оно просто управляет локальными файлами?Tolaria построена на файлах и git: каждое хранилище — это папка с обычными файлами markdown и YAML frontmatter, которая ведётся в git-репозитории и сохраняет полную историю версий. Собственного формата нет, и привязки к облаку тоже нет.
Установщик для Windows уже готов к использованию?Установщик для Windows подписан через Authenticode, но на компьютерах, которыми управляет компания, отдел ИТ может сначала потребовать одобрить издателя Tolaria, и только после этого первая установка завершится.
Нужен ли Tolaria интернет или аккаунт для работы?Нет. Аккаунтов и подписок нет, а хранилище полностью работает офлайн. Если перестать пользоваться Tolaria, ничего не потеряется, потому что ваши данные — это просто файлы markdown.
Какие ИИ-агенты для программирования поддерживает Tolaria?В Tolaria есть готовые способы настройки для Claude Code, Codex CLI и Gemini CLI. Там также есть файл AGENTS, по которому любой агент может разобраться в хранилище, и встроенный MCP-сервер, который открывает хранилище для ИИ-инструментов.
Tolaria заставляет заметки следовать жёстким шаблонам или обязательным полям?Нет. Типы в Tolaria служат ориентирами для навигации, а не обязательными схемами. Поэтому обязательных полей и проверки нет, есть только полезные категории для поиска заметок.
Зачем автор создал Tolaria?Создатель Лука сделал её, чтобы вести собственное рабочее пространство из более чем 10 000 заметок, где сочетаются его работа в Refactoring и личный дневник. Он пользуется ею каждый день как вторым мозгом.
Tolaria рассчитана на работу мышью или клавиатурой?Она рассчитана в первую очередь на клавиатуру и на опытных пользователей: Editor и Command Palette построены вокруг навигации с клавиатуры.
Size
105.4 MB
Stars
20.1K
Age
8mo
Commits · 90 Days