Introducing Tolaria 💧

2025-04-30 · Source: Refactoring · Field: Technology & Digital — Software Development & Engineering, Artificial Intelligence & Machine Learning · Depth: Intermediate, long

Summary

Tolaria is a newly released, free, and open-source desktop application for Mac designed to manage markdown knowledge bases. Developed by Luca, it serves as a personal knowledge management system, a repository for company documentation used as AI context, and memory for AI assistants like OpenClaw. The author uses it to manage over 10,000 notes accumulated over six years, having migrated from Notion to markdown for improved speed, control, and AI integration. Built with 100K lines of Rust + React code, 1900+ commits, 3000+ tests, and 70 ADRs, Tolaria emphasizes portability, offline work, and AI compatibility through its core principles of using files, Markdown, Git, and an open-source model.

Key takeaway

For AI Engineers or technical professionals building AI-powered workflows, Tolaria offers a robust, open-source solution for managing the critical context AI needs. Its emphasis on markdown files, Git version control, and a keyboard-first UX ensures data portability and efficient interaction, directly addressing the challenge of keeping proprietary knowledge under your control. Consider integrating Tolaria to centralize your team's documentation and personal knowledge, enhancing AI assistant performance and fostering a more controlled, scalable development environment.

Key insights

AI's greatest benefits come from effectively capturing and organizing context.

Principles

• Knowledge bases thrive on files, Markdown, Git, and open source.
• Rich UX and keyboard-first design are vital for large note collections.
• Maintain control over your data, independent of specific tools or AI platforms.

Method

Tolaria organizes content via a Sidebar for filtering, a Note list for display, an Editor for writing (WYSIWYG/Raw), and a Status bar for Git and AI status. It supports custom views and wikilinks.

In practice

• Use the Inbox workflow to manage unorganized notes weekly.
• Create custom YAML views for complex, nested filtering criteria.
• Leverage "[[" for wikilinks and "cmd+K" for keyboard-first commands.

Topics

• Markdown
• Knowledge Management
• AI Context
• Desktop Applications
• Git Version Control
• Open-Source Software

Code references

• refactoringhq/tolaria

Best for: Software Engineer, AI Engineer, Director of AI/ML

Related on AIssential

• refactoringhq / tolaria — Tolaria offers a robust, open-source, local-first solution for managing markdown knowledge bases, emphasizing user data ownership and standard compatibility.
• I found a two-finger gesture that makes AI actually useful on Windows 11 - Pocket-lint — Contextually aware AI features like "Click to Do" offer practical utility within operating systems, unlike many general-purpose AI chatbots.
• Mergeable by default: Building the context engine to save time and tokens — Peter Werry, Unblocked — Context engines optimize AI agent performance by providing highly relevant, curated organizational context, moving beyond simple data access.
• Codex for Open Source — OpenAI and Anthropic are offering free AI tools to support open-source project maintainers.
• Your AI forgets you every session. — A git-based markdown "second brain" provides persistent memory for AI agents, enabling knowledge compounding across sessions.
• DataBooks: Markdown as Semantic Infrastructure — DataBooks use Markdown's advanced features to create self-describing, portable semantic artifacts for small-scale graph data.

Open in AIssential →

Editorial summary, takeaway, and curation by AIssential. Original article published by Refactoring.