Tolaria is a desktop application designed for macOS to manage markdown-based personal knowledge bases and company documentation. It caters to power users, researchers, and teams looking to build "second brains," organize context for AI agents, or store operational procedures, offering a files-first and Git-first approach for complete data ownership and version control.

How It Works

Tolaria operates on several core principles: files-first, meaning all notes are plain markdown files; Git-first, treating each knowledge base vault as a Git repository for version history; and offline-first, requiring no accounts, subscriptions, or cloud dependencies. Notes adhere to standards like markdown and YAML frontmatter, ensuring portability and interoperability with other tools. While AI-first in its design, allowing seamless integration with AI agents via a dedicated AGENTS file and supporting CLIs like Claude Code and Codex, it remains AI-agnostic, empowering users to employ any AI tool. The application prioritizes a keyboard-first interaction model.

Quick Start & Requirements

Users can download the latest release directly. For local development or contribution, prerequisites include Node.js 20+, pnpm 8+, and Rust stable. The setup involves running pnpm install followed by pnpm dev for a browser mock or pnpm tauri dev for the native desktop application. Development requires macOS. Links to technical documentation such as ARCHITECTURE.md, ABSTRACTIONS.md, GETTING-STARTED.md, and ADRs are available within the repository.

Highlighted Details

• Designed to manage large workspaces, with the creator using it daily for over 10,000 notes.
• Emphasizes data portability and user control through plain markdown files and Git repository integration.
• Features an AI-first architecture, providing an AGENTS file for AI integration and supporting specific AI CLIs.
• Optimized for power users with a keyboard-first interface and command palette.

Maintenance & Community

The project appears to be primarily driven by its creator, Luca. Specific details regarding community channels (like Discord/Slack), active contributors, sponsorships, or a public roadmap are not detailed in the provided README.

Licensing & Compatibility

Tolaria is licensed under the AGPL-3.0-or-later license. This strong copyleft license requires derivative works to be shared under the same terms, which may impose restrictions on integration with closed-source or proprietary software. The project's name and logo are protected by a trademark policy.

Limitations & Caveats

The application is explicitly stated as a desktop app for Mac, indicating it is not cross-platform. While designed for AI integration, it currently lists support for specific CLIs (Claude Code, Codex CLI), suggesting a limited set of out-of-the-box AI tool compatibilities.