Does Tolaria Support Custom Refactoring Rules?

No, Tolaria does not support custom refactoring rules; it is a desktop‑first markdown knowledge‑base focused on note management and personal knowledge management, not code transformation.

Tolaria is a markdown knowledge‑base application built with Tauri, React, and TypeScript, developed by Refactoring HQ. While the name might suggest code manipulation capabilities, the application is designed to manage plain‑text markdown files with Git‑first versioning and AI‑assisted workflows. If you are searching for custom refactoring rules within this tool, it is important to understand that Tolaria's architecture contains no engine for defining or executing code transformations.

Why Tolaria Does Not Include Refactoring Capabilities

Tolaria functions exclusively as a knowledge management application, not as a development environment for source‑code manipulation. The codebase contains no built‑in refactoring engine, and according to docs/ARCHITECTURE.md, there is no mention of a refactoring subsystem or APIs that accept transformation rule definitions.

The term "refactoring" appears in the repository only as part of the brand identity—specifically referencing the company Refactoring HQ and the podcast Refactoring.fm. There are no configuration files, hooks, or utility functions that enable user‑defined code refactoring rules or automated code transformations.

What Tolaria Actually Supports: Custom Note Management

Instead of custom refactoring rules, Tolaria offers deep customization for markdown note organization. You can define custom note types, create templates for new notes, and customize UI colors for visual categorization.

Custom Note Types and Templates

The file src/hooks/useNoteCreation.ts implements a system for custom note‑type templates. When you create a new note, Tolaria can apply user‑defined templates based on the selected note type.

// Example: Creating a note using a custom type template
await handleCreateNoteImmediate({
  type: 'Recipe',          // custom type defined in the vault
  title: 'Chocolate Cake',
  template: customTemplates['Recipe'], // pulled from the type entry
});

Custom Type Colors for Visual Organization

For UI customization, src/utils/typeColors.ts provides a mapping system for custom type colors used throughout the interface.

// Example: Adding a custom note type with a bespoke color
import { getTypeColor } from '@/utils/typeColors';

// In a UI component that displays a note type badge:
const badgeColor = getTypeColor(entry.isA, entry.customColorKey);
// badgeColor can be a user-defined hex value like '#ff6600'

Working With External Refactoring Tools

Since Tolaria does not provide custom refactoring rules, developers requiring automated code transformations must integrate external tools. You would need to run separate refactoring libraries or CLI tools outside of Tolaria's environment, as the application exposes no plugin architecture or API for code transformation.

Summary

• Tolaria is a markdown knowledge‑base application, not a code refactoring tool.
• The term "refactoring" appears only in the brand name (Refactoring HQ, Refactoring.fm), not as a software feature.
• No APIs exist in src/hooks/useNoteCreation.ts, src/utils/typeColors.ts, or elsewhere for defining code transformation rules.
• Actual customization is limited to note types, templates, and UI colors.
• For code refactoring capabilities, integration with external tools is required.

Frequently Asked Questions

Can I use Tolaria to refactor my codebase?

No. Tolaria is designed exclusively for managing markdown knowledge bases and personal notes. It contains no source code transformation capabilities, refactoring engines, or syntax manipulation tools according to the source code analysis.

What does the "Refactoring" in Tolaria's name refer to?

The name references Refactoring HQ, the company that develops the application, and their associated podcast Refactoring.fm. This is purely a brand association and does not indicate functionality related to code refactoring or transformation rules.

How can I customize Tolaria if not with refactoring rules?

You can customize Tolaria by defining custom note types in your vault, setting custom colors for types via src/utils/typeColors.ts, and creating templates for new notes in src/hooks/useNoteCreation.ts. These features affect how you organize and visualize your markdown content.

Is there a way to integrate external refactoring tools with Tolaria?

While Tolaria does not have a native API for custom refactoring rules, you could theoretically integrate external refactoring tools alongside Tolaria as separate processes. However, there is no built‑in integration point, plugin system, or configuration within the Tolaria architecture designed to support such tools.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}