refactoringhq /tolaria
Desktop app to manage markdown knowledge bases
★ 20,521⑂ 1,414👁 50⑃ 406● 844▤ 2,110
+6
日增长
+72
周增长
20,521
stars
1,414
forks
50
watchers
406
prs
844
issues
2,110
releases
README
!Latest stable
💧 Tolaria
Tolaria is an app for managing markdown knowledge bases, available on desktop (macOS, Windows, Linux) and mobile (iPhone, iPad). 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.
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.
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
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.
- 🔌 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.
- 🛜 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.
- 🔬 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, 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.
- ⌨️ 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.
Installation
Homebrew
Install via Homebrew on macOS:
batch
brew install --cask tolaria
Download from releases
Download the latest release here for macOS, Windows, or Linux. WTop issues
#1102Mobile app (`apps/mobile`) traps at launch on a physical iPad — `RCTKeyCommands` is simulator-only2 comments · 2026-08-03#1323Editor quirks1 comments · 2026-11-09#1296Why are translated strings not working?1 comments · 2026-10-27#1331Mobile fixture scenario selection accepts inherited object keys0 comments · 2026-11-13#1329Cannot input Chinese characters via IME in the AI chat panel (only English/Latin letters work)0 comments · 2026-11-13#1325Auto-update doesn't work with .deb and .rpm packages0 comments · 2026-11-11#1314Mobile active vault retains old link slug after saved workspace slug edit0 comments · 2026-11-03#1313Mobile incoming links can select a vault after the routing hook unmounts0 comments · 2026-11-02
Discussions
#1333Section Links0 comments · 2026-11-15#1326Ability to exclude folders, manage code projects0 comments · 2026-11-12#1289Feature Request: Support Type Inheritance / Subtypes (via `belongs_to` or similar)0 comments · 2026-10-25#1283Tolaria for iOS, Discord, and a small apology0 comments · 2026-10-21#1272Feature request: Zetteltasken node IDs, filename templates, and frontmatter support0 comments · 2026-10-15#1230Multiple Claude accounts1 comments · 2026-09-15#1210What about transition from markdown to quarkdown ?1 comments · 2026-09-05#1202Best way currently to surface Tasks/Todos?0 comments · 2026-09-03
Latest release
Tolaria v2026-11-10 v2026-11-10 2026-11-10Improvements - 🇷🇺 Clearer Russian translations — A few leftover English labels in the Russian localization, including Name and Diff, are now translated. Stability and Fixes - Pasting formatted text into a quote block now stays inside the quote. - Pasting markdown-style emphasis in the editor is more reliable on macOS. - Undo after pasting a filename works as expected again. - Clicking into a fenced code block now places the cursor inside the block. - The Commit & Push dialog keeps its contents inside the window, even with a long author email. - Windows WSL Git paths are shown in a readable