# tolaria | Refactoring | Knowledge Base | Instagit Desktop app to manage markdown knowledge bases GitHub Stars: 9.3k Repository: https://github.com/refactoringhq/tolaria --- ## Articles ### [How to Report Bugs in Tolaria: A Complete Guide to GitHub Issues and Security Disclosures](/refactoringhq/tolaria/how-to-report-bugs-in-tolaria) Learn how to report bugs in Tolaria efficiently. Discover the correct methods for submitting standard bugs via GitHub Issues and security vulnerabilities through private email. - Tags: how-to-guide - Published: 2026-05-04 ### [Common Use Cases for Tolaria: A Git-Backed Markdown Knowledge Base](/refactoringhq/tolaria/what-are-the-common-use-cases-for-tolaria) Discover Tolaria's common use cases. Manage markdown knowledge bases for note-taking, team docs, and AI memory with this git-backed desktop app. - Tags: use-cases - Published: 2026-05-04 ### [How to Use Tolaria for Code Transformation: Markdown Processing Utilities Explained](/refactoringhq/tolaria/how-to-use-tolaria-for-code-transformation) Discover how to use Tolaria for code transformation. This guide explains its TypeScript utilities for converting markdown with wikilinks and LaTeX to BlockNote data and back for programmatic manipulation. - Tags: how-to-guide - Published: 2026-05-04 ### [Community Support for Tolaria: How the Open-Source Project Engages Its 2,000+ Engineer Network](/refactoringhq/tolaria/what-is-the-community-support-for-tolaria) Discover how Tolaria fosters community support with its FeedbackDialog, connecting users to GitHub Discussions, a 2000+ engineer network, feature requests, and bug reporting. - Tags: community-spotlight - Published: 2026-05-04 ### [How Tolaria Ensures Safety During Refactoring: Disk-First Architecture and Atomic Guarantees](/refactoringhq/tolaria/how-does-tolaria-ensure-safety-during-refactoring) Learn how Tolaria ensures refactoring safety with its disk-first architecture and atomic guarantees. Discover the three-representation invariant for UI recovery. - Tags: internals - Published: 2026-05-04 ### [Tolaria's Limitations: Understanding the Constraints of a Markdown-First Knowledge Base](/refactoringhq/tolaria/what-are-tolarias-limitations) Explore Tolaria's limitations: filesystem-only, 20-result search cap, AI context truncation, single-note editing, and mandatory Git. Understand the constraints before adopting this Markdown knowledge base. - Tags: deep-dive - Published: 2026-05-04 ### [How to Contribute to the Tolaria Project: A Complete Guide for Developers](/refactoringhq/tolaria/how-to-contribute-to-the-tolaria-project) Learn how to contribute to the Tolaria project. Follow this guide to fork the repo, set up your dev environment, write tests, and submit PRs effectively. - Tags: how-to-guide - Published: 2026-05-04 ### [Benefits of Using Tolaria for Refactoring: A Deep Dive into the Four-Panel Architecture](/refactoringhq/tolaria/what-are-the-benefits-of-using-tolaria-for-refactoring) Discover the benefits of using Tolaria for refactoring. Achieve safe, auditable, and reversible large-scale refactoring with its four-panel architecture and AI tools. - Tags: deep-dive - Published: 2026-05-04 ### [Tolaria Command-Line Interface: A Complete Guide to npm Scripts and Development Commands](/refactoringhq/tolaria/what-is-the-command-line-interface-for-tolaria) Explore the Tolaria Command-Line Interface defined by npm scripts in package.json. Learn to develop test build and package the desktop app efficiently. - Tags: how-to-guide - Published: 2026-05-04 ### [Does Tolaria Support Custom Refactoring Rules?](/refactoringhq/tolaria/does-tolaria-support-custom-refactoring-rules) Tolaria does not support custom refactoring rules. It is a desktop markdown knowledge base for note management, not code transformation. - Tags: faq - Published: 2026-05-04 ### [How to Configure Tolaria for Specific Projects: A Complete Guide to Frontmatter and Type Documents](/refactoringhq/tolaria/how-to-configure-tolaria-for-specific-projects) Configure Tolaria for specific projects using frontmatter and type documents. This guide details how to customize settings for your projects with Tolaria. - Tags: how-to-guide - Published: 2026-05-04 ### [Performance Considerations for Tolaria: Zero-Overhead Instrumentation and Virtualized Rendering](/refactoringhq/tolaria/what-are-the-performance-considerations-for-tolaria) Explore Tolaria's performance: zero overhead instrumentation via DEV checks and smooth UI with virtualized lists and requestAnimationFrame. Optimize your app now. - Tags: performance - Published: 2026-05-04 ### [Prerequisites for Running Tolaria: Complete Setup Guide for Node.js, Rust, and Tauri](/refactoringhq/tolaria/what-are-the-prerequisites-for-running-tolaria) Discover the essential prerequisites for running Tolaria. Install Node.js, pnpm, Rust, and git CLI. Learn about Linux specific requirements like WebKit2GTK for a smooth setup. - Tags: how-to-guide - Published: 2026-05-04 ### [How Tolaria Handles Complex Codebases: A Three-Layer Architecture Deep Dive](/refactoringhq/tolaria/how-does-tolaria-handle-complex-codebases) Discover how Tolaria handles complex codebases with its three-layer architecture. Learn how it synchronizes JSON disk cache, React state, and Git updates for optimal performance. - Tags: architecture - Published: 2026-05-04 ### [Is Tolaria a Static Analysis Tool? Understanding Its Architecture and Purpose](/refactoringhq/tolaria/is-tolaria-a-static-analysis-tool) Tolaria isn't a static analysis tool. Discover how this desktop app manages Markdown knowledge bases efficiently with file operations and keyword search. - Tags: deep-dive - Published: 2026-05-04 ### [Can Tolaria Be Used for Automated Refactoring?](/refactoringhq/tolaria/can-tolaria-be-used-for-automated-refactoring) Yes, Tolaria powers automated refactoring by exposing Git-tracked vault operations as tool calls for AI agents to programmatically read, edit, rename, and commit markdown notes via its MCP server. - Tags: getting-started - Published: 2026-05-04 ### [How Tolaria's Internal Architecture Works: A Deep Dive into the Rust-React Data Flow](/refactoringhq/tolaria/how-does-tolarias-internal-architecture-work) Explore Tolaria's internal architecture. Understand the Rust-React data flow in this Tauri app where the filesystem is the single source of truth for all UI mutations. - Tags: deep-dive - Published: 2026-05-04 ### [Main Features of Tolaria: Local-First Markdown Knowledge Base](/refactoringhq/tolaria/what-are-the-main-features-of-tolaria) Discover Tolaria's main features including local-first markdown storage, AI assistance, Git integration, and conflict-aware sync. Manage your knowledge base efficiently. - Tags: getting-started - Published: 2026-05-04 ### [What Programming Languages Does Tolaria Support?](/refactoringhq/tolaria/what-programming-languages-does-tolaria-support) Discover which programming languages Tolaria automatically detects for syntax highlighting. Learn more about its comprehensive language support for your code blocks. - Tags: getting-started - Published: 2026-05-04 ### [How to Install Tolaria: Complete Setup Guide for macOS, Windows, and Linux](/refactoringhq/tolaria/how-to-install-tolaria) Learn how to install Tolaria on macOS, Windows, and Linux. Follow our complete setup guide for easy installation using brew, binaries, or compiling from source. - Tags: getting-started - Published: 2026-05-04