Tolaria

Tolaria is a cross-platform desktop app for organizing large markdown knowledge bases, built by the creator of the Refactoring newsletter to manage a personal workspace of 10,000+ notes spanning journaling, work notes, and second-braining. Beyond personal knowledge management, it’s also positioned for organizing company documentation as AI context, and for storing AI assistant memory and procedures — treating markdown notes as infrastructure for both humans and AI agents to read.

Being local-first and file-based (plain markdown), Tolaria avoids the vendor lock-in of proprietary note formats: your knowledge base is just files on disk, portable across tools and readable without the app.

AGPL-3.0 licensed and explicitly free and open source (per the project’s own description), Tolaria tracks code health via Codecov and CodeScene alongside standard CI, and has grown to over 18,000 GitHub stars.

What You Get

• A cross-platform desktop app (macOS, Windows, Linux) for organizing markdown-based knowledge bases
• Local-first, file-based storage — your notes are plain markdown files, not a proprietary format
• Support for large-scale personal knowledge management, tested against a real 10,000+ note workspace
• A use case for storing AI assistant memory and procedures, not just human-facing notes

Common Use Cases

• Running a personal “second brain” knowledge management system with plain markdown files
• Organizing company documentation as structured context for AI-assisted development or internal tooling
• Storing and organizing AI assistant memory, procedures, and context in a human-browsable format
• Migrating away from a proprietary note-taking tool to avoid vendor lock-in on note format and storage

Under The Hood

Architecture Tolaria is a local-first desktop application operating directly on markdown files rather than importing them into a proprietary database, which is what makes the knowledge base portable and readable outside the app itself. The project explicitly tracks code health metrics via CodeScene (hotspot code health) alongside standard CI and Codecov coverage tracking, reflecting deliberate attention to maintainability at scale as the note count and codebase grow.

Tech Stack TypeScript, packaged as a cross-platform desktop app for macOS, Windows, and Linux. CI runs on every change with coverage tracked via Codecov, and CodeScene provides ongoing hotspot/code-health monitoring beyond typical CI checks.

Code Quality The combination of CI, Codecov, and CodeScene badges in the README is a notably thorough quality-tracking setup for an open-source desktop app, paired with very active, consistently maintained commit history — indicating the maintainer treats codebase health as a first-class, continuously monitored concern rather than a one-time setup.

What Makes It Unique Most note-taking apps optimize purely for human readability; Tolaria’s explicit secondary use case — storing AI assistant memory and procedures, and organizing company docs as AI context — reflects a knowledge-base design aimed at being consumed by both humans and AI agents, not just one or the other.

Self-Hosting

Licensing Model AGPL-3.0 licensed — the project describes itself as free and open source with no license key.

Self-Hosting Restrictions Not applicable; it’s a local desktop application with no hosted service or account requirement.

License Key Required No.