Tolaria: ein lokales Markdown-Gehirn für das Zeitalter der KI-Agenten

Eine Desktop-App (macOS, Windows und Linux) zur Verwaltung von Markdown-Wissensdatenbanken: flache Dateien mit YAML-Frontmatter, Git als Historien- und Sync-Schicht, ein blockweiser Notion-artiger Editor und erstklassig integrierte KI-Agenten (Claude Code, Codex und andere).

Was es ist

refactoringhq/tolaria ist eine offene Desktop-App (AGPL-3.0-Lizenz) zur Verwaltung von Markdown-Wissensdatenbanken. Jede Notiz ist eine flache .md-Datei mit YAML-Frontmatter; jeder „Vault” (Tresor) ist ein Ordner, der ein Git-Repository sein kann; die Oberfläche bietet einen reichhaltigen, blockweisen Editor (Slash-Befehle, Wikilinks mit Autovervollständigung, Tabellen, Tabellenkalkulationen, gespeicherte Ansichten) über diesen Dateien, ohne Datenbank und ohne proprietäres Format.

Drei Anwendungsfälle, die das README ausdrücklich nennt:

Ein „zweites Gehirn” und persönliches Wissen betreiben.
Die Dokumentation eines Unternehmens als Kontext für KI organisieren.
Das Gedächtnis und die Abläufe von Assistenten/Agenten speichern (das README erwähnt OpenClaw und Assistenten im Allgemeinen).

Der Autor, Luca Rossi (Account LucaRonin auf GitHub, lucaronin auf X), baute es, um seinen eigenen Workspace mit über 10.000 Notizen zu verwalten, angesammelt über fünf Jahre beim Schreiben des technischen Newsletters Refactoring (refactoring.fm, laut eigener Website über 170.000 Abonnenten, und 300+ Artikel). Die öffentliche Dokumentation lebt im Repository selbst (Ordner site/, veröffentlicht auf GitHub Pages), und die offizielle Seite ist tolaria.md.

Ursprung

Das Repository wurde am 14. Februar 2026 unter der GitHub-Organisation refactoringhq erstellt. docs/VISION.md (geschrieben von „Brian” auf Basis von Gesprächen mit Luca Rossi zwischen Februar und März 2026) dokumentiert die Genese: Nach fünf Jahren Vollzeit-Schreiben bei Refactoring hatte Rossi 9.000+ Notizen in einem Notion-Workspace angesammelt, „viel über Wissensmanagement, Produktivität und, in jüngerer Zeit, über gutes Arbeiten mit KI über Dokumenten gelernt”, und baute, da er kein passendes bestehendes Tool fand, selbst eines.

Tolarias Ursprung: ein lokales Archiv von 10.000 Notizen, angesammelt über fünf Jahre eines technischen Newsletters

Ein Detail aus demselben Dokument: Tolaria begann in Swift, aber Luca stieß auf reale Grenzen beim Markdown-Editor (es ist schwer, etwas „Notion-artiges” in Swift zu bauen) und wechselte zu Tauri 2 + React + TypeScript (mit src-tauri in Rust). Luca selbst bestätigt das auf Hacker News angesichts der Kritik, es sei ein „Webwrapper”.

Auch die Launch-Erzählung ist dokumentiert: Am 22. April 2026 veröffentlichte er die Seite tolaria.md auf HN (Thread 47865031, 3 Punkte, 0 Kommentare) und am nächsten Tag, dem 23. April 2026, den Haupt-„Show HN” (47882697, 318 Punkte, 142 Kommentare). Im Einreichungstext stellt sich Luca vor und erklärt: Er baute Tolaria für sich selbst (10K Notizen, 300+ Artikel über mehr als 6 Jahre Newsletter), es ist offline-first, dateibasiert, hat erstklassiges Git und „starke Meinungen” darüber, wie Notizen zu organisieren sind (Types, Relationships).

VISION.md erklärt außerdem, warum es kostenlos und Open Source ist: Der Erfolg des Projekts fungiert als Reputations- und Akquisekanal für den Newsletter Refactoring („es ist kein Produkt auf Marktsuche; es ist ein Tool, gebaut von seinem ersten Power-User, für ein Publikum, das ihn bereits kennt und ihm vertraut”). Die erste im Repository erhaltene Stable-Release-Notiz (release-notes/stable-v2026.5.2.md, Mai 2026) enthielt bereits polnische Oberflächenunterstützung, was den Startpunkt der „Stable”-Linie markiert.

Philosophie und Prinzipien

Das README nennt neun verifizierbare Prinzipien:

Files-first (Dateien zuerst) — Notizen sind reines Markdown: portabel, mit jedem Editor bearbeitbar, kein Exportschritt nötig.

Tolarias Files-first-Philosophie: flache Markdown-Notizen mit YAML-Frontmatter, ohne Datenbank, ohne proprietäres Format

Git-first — jeder Vault ist ein Git-Repository: vollständige Historie, beliebiges Remote, null Abhängigkeit von Tolaria-Servern.
Offline-first, kein Lock-in — keine Konten, keine Abos, keine Cloud.
Open Source — kostenlos und offen; für sich selbst gebaut und zum Teilen gedacht.
Standardbasiert — Markdown + YAML-Frontmatter; keine proprietären Formate.
Types as lenses, not schemas (Typen als Linsen, nicht als Schemata) — Typen sind Navigationshilfen, keine Durchsetzungsmechanismen: keine Pflichtfelder, keine Validierung.
AI-first, aber nicht AI-only — ein Datei-Vault funktioniert sehr gut mit KI-Agenten, lässt sich aber mit jedem Tool bearbeiten; unterstützt Konfigurationspfade für Claude Code, Codex CLI und Gemini CLI und stellt eine AGENTS.md-Datei bereit, die Agenten interpretieren.
Keyboard-first — für Power-User konzipiert: Editor und Command Palette sind auf die Tastatur ausgerichtet.
Built from real use — entstand, um 10.000+ eigene Notizen zu verwalten; „jedes Feature existiert, weil es ein echtes Problem gelöst hat”.

Blockweiser, Notion-artiger Editor, keyboard-first konzipiert: Command Palette, Slash-Befehle und Wikilinks

Das Vision-Dokument fügt die methodische Ebene hinzu — „die Methode wird zusammen mit dem Tool geliefert” (tool and method, together):

Wissensontologie: zwei Achsen (einmalig / wiederkehrend × mehrsitzungsübergreifend / einmalige Sitzung), die Project, Responsibility, Procedure und Task erzeugen, plus Kontext: Notes, Topics, Events, People.
Wissen hat einen Zweck: „Notizen existieren, um Dinge zu tun”, nicht um gespeichert zu werden.
Zwei Phasen: Erfassung und Organisation. Schnell und reibungslos erfassen; bewusst und periodisch organisieren (der Inbox zeigt Notizen ohne ausgehende Relationen; das Ziel ist wöchentliches „Inbox Zero”; mehr als 50 % des Erfassten zu löschen „ist normal und gesund”).

Erfassungs- und Organisationsablauf: schnelles Eingangsfach, periodische Durchsicht und wöchentliches Inbox-Zero-Ziel

Convention over Configuration: bedeutungsvolle Felder (status:, Workspace:, Belongs to:, start_date:/end_date:) lösen ohne jegliche Konfiguration reichhaltiges Verhalten aus; Overrides leben in Vault-Dateien (config/relations.md, config/semantic-properties.md).
Warum nicht Obsidian (ein eigener Abschnitt im VISION): Obsidian ist eine unendlich konfigurierbare „leere Leinwand” und behandelt Git als Zusatz (sein Geschäftsmodell dreht sich um proprietäre Synchronisation); Tolaria ist opinionated, liefert standardmäßig ein vollständiges Wissensframework und behandelt Git als erstklassigen Bürger.

Wie es funktioniert

Datenmodell. Ein Vault ist der Ordner, den die App liest und beschreibt; das Dateisystem ist die einzige Quelle der Wahrheit, und App-Zustand und Cache leiten sich aus den Dateien ab. Notizen sind Markdown mit YAML-Frontmatter; Anhänge sind normale Dateien innerhalb des Vaults; Typdefinitionen und gespeicherte Ansichten sind ebenfalls Dateien.

Types. Das Feld type: weist einer Notiz einen Typ zu (Project, Person, Topic, Procedure, Event oder eine beliebige eigene Kategorie). Tolaria leitet den Typ nicht aus dem Ordnerstandort ab. Typen werden Ordnern vorgezogen. „Typ-Dokumente” (Notizen mit type: Type im Frontmatter) definieren Icon (_icon), Farbe (_color), Label und Reihenfolge in der Seitenleiste, gepinnte Eigenschaften und Vorlagen für neue Notizen.

Relationships. Jedes Frontmatter-Feld, das Wikilinks enthält, wird zu einer Relation. Standardfelder sind belongs_to, has und related_to; benutzerdefinierte Felder mit Wikilinks werden dynamisch erkannt. Standardrelationen haben automatisch berechnete Umkehrungen (wenn eine Notiz belongs_to einem Projekt ist, zeigt das Projekt sie unter has). Eingehende Links und umgekehrte Relationen erscheinen im Eigenschaften-Panel und im Neighborhood-Modus (eine Graphansicht rund um die ausgewählte Notiz).

Typen als Linsen: Project, Responsibility, Procedure, Task, Note, Topic, Event und Person mit automatisch berechneten Umkehrrelationen

Inbox. Ein abgeleiteter Bereich (kein Ordner), der alle Notizen ohne ausgehende Relationen zeigt. Optional: lässt sich in Settings > Workflow deaktivieren.

Integriertes Git. Tolaria fungiert als leichter Git-Client für den Vault: Historie und Diff für den gesamten Vault und pro Notiz, lokale Commits, Pull/Push, Konflikterkennung und -auflösung sowie Remote-Verbindungen. Es nutzt die Git-Authentifizierung des Systems (GitHub CLI, SSH, Credential-Helper, Keychain). AutoGit erstellt konservative automatische Commits und Pushes nach Bearbeitungspausen oder wenn die App inaktiv wird. Ein Vault kann ein Ordner innerhalb eines größeren Repos sein: Tolaria entdeckt das übergeordnete Worktree, begrenzt den Umfang von Status/Diffs/Commits aber auf die Dateien des Vaults.

In Tolaria integriertes Git: Historie und Diff pro Vault, lokale Commits, Pull/Push und AutoGit nach Bearbeitungspausen

KI, zwei Wege. (1) Coding-Agenten: Das KI-Panel streamt lokale CLI-Agenten über eine normalisierte Event-Schicht. Dokumentierte unterstützte Agenten: Claude Code, Codex, GitHub Copilot, OpenCode, Pi, Antigravity CLI, Kiro und Hermes Agent. Jeder Agent behält seine eigene Authentifizierung. Zwei Berechtigungsmodi pro Vault: Vault Safe (beschränkt auf Datei-, Such- und Bearbeitungstools) und Power User (erlaubt lokale Shell, begrenzt auf den aktiven Vault, für Agenten, die dies unterstützen). Manche Agenten bieten einen Modellwähler (Codex und die dokumentierten Aliase von Claude Code). (2) Direkte Modelle: Chat über den Kontext der Notiz (aktive Notiz, verlinkter Kontext und Gesprächsverlauf), ohne Schreibwerkzeuge für den Vault oder Shell. Anbieter: Ollama, LM Studio (lokal) sowie OpenAI, Anthropic, Gemini, OpenRouter oder OpenAI-kompatible Endpunkte. Der Inline-Prompt wird mit Cmd+K + Leertaste ausgelöst.

MCP. Tolaria enthält einen MCP-Server (Verzeichnis mcp-server/, Node.js mit ws-bridge.js und vault-lifecycle.js) für externe Tools. Der Einrichtungsablauf kann Tolarias MCP-Eintrag in die Konfigurationen von Claude Code, Antigravity CLI und Cursor schreiben, in einen generischen MCP-Konfigurationspfad, oder das exakte JSON-Snippet für manuelle Einrichtung kopieren; es ist explizit (das Schließen des Dialogs rührt keine Dateien Dritter an). Tools: Vault-Inhalte suchen und lesen, Notizen erstellen, eine ganze Notiz aktualisieren (mit optionalem Modification-Time-Guard für sichereres Read-Modify-Write) und an bestehende Notizen anhängen; Schreibvorgänge aktualisieren Tolaria nach der Änderung.

Lokale KI-Agenten, verbunden mit dem Vault: Vault-Safe- und Power-User-Modi, plus MCP-Server mit WebSocket-Brücken

Multi-Vault. Mehrere registrierte Vaults lassen sich in einem vereinheitlichten Graphen laden (Settings -> Vaults -> „Use multiple vaults at the same time”); Cross-Vault-Wikilinks nutzen stabile Aliase des Ziel-Vaults, z. B. [[team/projects/alpha]].

Ein Multi-Vault-Ökosystem: separate Vaults, verbunden durch Cross-Vault-Wikilinks mit stabilen Aliasen

Das Ökosystem

Schwester-Repositories der Organisation refactoringhq (GitHub-API, 25. August 2026):

refactoringhq/portent (69 Sterne) — eine offene Spezifikation für portable Wissensdatenbanken. Definiert 8 Standardtypen in zwei Gruppen: PORT (Project, Operation, Responsibility, Task — handlungsfähige Dinge) und ENTP (Event, Note, Topic, Person — Wissenseinträge); zwei Standardrelationen (belongs_to, related_to) und einen dreiteiligen Lebenszyklus (capture → organize → archive). „Portent lässt sich am einfachsten in Tolaria implementieren, ist aber darauf ausgelegt, über dateibasierte Systeme, Notiz-Apps, Doku-Tools und agentenlesbare Vaults hinweg portabel zu sein.” Seite: portent.md.
refactoringhq/portent-vault-template (84 Sterne) — eine Starter-Vault-Vorlage mit den Standard-Typdefinitionen von Portent.
refactoringhq/tolaria-getting-started (31 Sterne) — der „Getting Started”-Vault, den die App beim ersten Start zum Klonen anbietet (lokal geklont und dann von seinem Remote getrennt, damit das Tutorial gefahrlos bearbeitet werden kann).

Forks und Ports der Community:

primitiver/tolaria-zh (6 Sterne) — eine chinesische Übersetzung des README und des Projektmaterials (eine ausgetauschte README-Version auf Mandarin).
hhungxun/tolaria-docs — eine eigenständige Dokumentationsseite für Tolaria, gebaut mit Astro und Starlight (veröffentlicht auf GitHub Pages).
feir/Save-To-Tolaria — eine Chrome-Erweiterung, die Webinhalte als saubere Markdown-Notizen in einem Tolaria-Vault speichert: mehrschichtige Extraktion (Twitter/X-APIs über FxTwitter, Reddit, GitHub, YouTube; dann Defuddle; dann Jina Reader als Fallback), frontmatter-bewusst gegenüber den Typen des Vaults, Regeln nach URL-Muster, optionale LLM-Zusammenfassung (OpenAI- oder Claude-kompatible Endpunkte), Tastenkürzel Cmd+Shift+S/Ctrl+Shift+S und Live-Vault-Refresh per WebSocket.
pcamp96/tolaria-sync — ein Live-Sync-Client für Tolarias Editor (ein Projekt in früher Phase).

Verwandte Projekte und Wettbewerber mit echtem Bezug (beschrieben im Launch-HN-Thread und auf GitHub):

sig-ai-app/sig-releases (82 Sterne, erstellt am 24. April 2026, einen Tag nach dem Show HN) — „Sig — Your AI finally knows what’s going on at work”. Der Autor, Adam Ramirez (smadam9 auf HN), kündigt es direkt im Thread an: „du warst mir einen Tag voraus… die architektonische Überschneidung ist offensichtlich: macOS, reines Markdown, Git-versioniert, als Kontext für KI-Agenten konzipiert. Der Unterschied ist, wo es im Workflow ansetzt: Tolaria scheint beim Organisieren bereits vorhandenen Wissens zu glänzen; Sig…” (das Repo leitet von adamjramirez/sig-releases weiter).
rillmd/rill (6 Sterne) — ein PKM mit Sprach-Journaling und KI-Wissensdestillation, „Markdown + Git”, gebaut als Vault-Schicht über Claude Code; erwähnt von tarr1124 im HN-Thread.
Von Nutzern auf HN genannte Alternativen (nur die im Thread verifizierbaren): octarine.app (erwähnt von stock_toaster), HelixNotes (codeberg.org/ArkHost/HelixNotes, erwähnt von Barbing), mdnb.app (eine native macOS-Markdown-App, zweimal erwähnt von nicoritschel).

Tools, die Tolaria nutzt/sponsert: Codacy, CodeScene, CircleCI und Unblocked erscheinen als Sponsoren-Panel im README.

Offizieller / halboffizieller Status

Tolaria wurde nicht in einen offiziellen Marketplace aufgenommen und hat kein Vendor-Endorsement; sein Status ist der eines Open-Source-Projekts eines unabhängigen Autors/einer unabhängigen Organisation. Was in dieser Recherche verifiziert werden konnte:

Homebrew: Es existiert ein offizielles Cask im Homebrew-Register (brew install --cask tolaria), bestätigt über die API von formulae.brew.sh (Name „Tolaria”, Beschreibung „Markdown knowledgebase manager”). Es ist der unterstützte Installationsweg unter macOS und ein Standard-Indikator für Community-Adoption.
Eigene Spezifikation: Die Org veröffentlichte Portent als „open specification for portable knowledge base systems” (portent.md), eine Wette darauf, zum De-facto-Referenzpunkt für agentenlesbare Vaults zu werden, wenngleich bisher ohne verifizierbare externe Adoption über die eigene Repo-Familie von refactoringhq hinaus.
De-facto-Kompatibilität mit dem Agenten-Ökosystem: Durch das Bereitstellen eines MCP-Servers und von AGENTS.md/CLAUDE.md/GEMINI.md-Dateien fügt sich Tolaria in das dominante Muster „lokaler Vault + CLI-Agent” ein, das mit Claude Code, Codex, Cursor und ähnlichen Tools genutzt wird, ohne formale Zertifizierung eines dieser Anbieter.
Trending: Das Repository erreichte Githubs Trending-Listen (mehrere YouTube-Shorts betiteln sich „GitHub Trending Repositories: refactoringhq/tolaria” und „tolaria - GitHub Trending Today”), wenngleich ein Screenshot der eigentlichen Liste nicht verifiziert wurde.
Marke: Im Repo existiert eine trademarks.md; das README stellt klar, dass Name und Logo von Tolaria weiterhin der Markenrichtlinie des Projekts unterliegen (die Lizenz ist AGPL-3.0-or-later, aber die Marke bleibt separat).

Schnellstart-Anleitung

Installation und erster Start

macOS (Homebrew):
```
brew install --cask tolaria
```
Manueller Download (macOS, Windows oder Linux) von der Download-Seite: https://tolaria.md/download/ (oder von den GitHub-Releases). Status je Plattform laut Dokumentation: macOS ist die primäre Plattform (Apple Silicon und Intel, mit Homebrew); Windows („Supported, early”): NSIS-Installer und mit Tauri signierte Update-Bundles; die Installationsdokumentation weist darauf hin, dass die Authenticode-Signatur des Publishers hinzugefügt wird, sobald das Windows-Zertifikat bereitsteht, und verwaltete Firmengeräte (SmartScreen/WDAC) können IT-Freigabe erfordern. Linux („Supported, early”): AppImage, .deb und RPM werden veröffentlicht; das Verhalten hängt von WebKitGTK und der Input-Method-Integration der Distribution ab.
Erster Start: Tolaria bietet drei Optionen: den Getting-Started-Vault erstellen oder klonen (lokal geklont und dann von seinem Remote getrennt), einen bestehenden lokalen Vault öffnen (beliebiger Ordner mit Markdown-Dateien) oder einen neuen leeren erstellen. Dokumentierte Startbefehle: Cmd+K/Ctrl+K öffnet die Command Palette; New Note; Open Getting Started Vault; Reload Vault.
Aus dem Quellcode bauen (zum Beitragen oder Entwickeln): Voraussetzungen sind Node.js 20+, pnpm 8+, Rust stable sowie macOS oder Linux. Unter Linux (Tauri 2) werden WebKit2GTK 4.1 und GTK 3 benötigt (z. B. unter Debian/Ubuntu: sudo apt install libwebkit2gtk-4.1-dev build-essential ... librsvg2-dev libsoup-3.0-dev patchelf). Dann:
```
pnpm install
pnpm dev        # Mock-Modus im Browser (http://localhost:5173)
pnpm tauri dev  # native Desktop-App
```
Unter Linux startet der mitgelieferte MCP-Server zur Laufzeit die node-Binärdatei des Systems, daher lohnt es sich, Node über den Paketmanager zu installieren, wenn man den Flow für externe KI-Tools nutzen möchte.

Übliche Workflows

Erfassen und dann organisieren: eine Notiz erstellen (oder aus dem Web speichern); sie beginnt ohne ausgehende Relationen und erscheint im Inbox. Beim wöchentlichen Organisationsdurchgang: eine klare H1 setzen, type: zuweisen, status/Daten/URL hinzufügen, falls relevant, und mit Wikilinks oder Frontmatter-Feldern (belongs_to, related_to) verbinden. Sobald sie verbunden ist, verlässt sie automatisch den Inbox.
Mit Git versionieren und synchronisieren: den Remote-Chip in der unteren Statusleiste öffnen (oder Add Remote aus der Command Palette), die Remote-URL einfügen und den Namen bestätigen; Tolaria nutzt die Git-Authentifizierung des Systems (SSH, GitHub CLI, Keychain). Für automatische Checkpoints AutoGit in Settings aktivieren: es committet und pusht nach einer Inaktivitätspause.
Mit KI arbeiten: In Settings das standardmäßige KI-Ziel wählen — einen Coding-Agenten (Claude Code, Codex, GitHub Copilot, OpenCode, Pi, Antigravity CLI, Kiro oder Hermes Agent) für werkzeuggestützte Vault-Bearbeitung, oder ein lokales/API-Modell für schreibfreien Chat. Für einen punktuellen Prompt beim Schreiben: Cmd+K + Leertaste, dann den Prompt im Kontext der Notiz eingeben. Änderungen wie Dateibearbeitungen überprüfen: Diff und Git-Historie vor dem Commit.
Einen externen Agenten per MCP verbinden: den MCP-Einrichtungsablauf aus der App öffnen; wählen, den Eintrag in die Konfiguration von Claude Code, Antigravity CLI oder Cursor zu schreiben, in einen generischen MCP-Pfad, oder das exakte JSON-Snippet für manuelle Einrichtung kopieren. Der Agent kann dann den Vault durchsuchen/lesen, Notizen erstellen, sie aktualisieren (mit optionalem mtime-Guard) oder Inhalte anhängen.

Wesentliche Konfiguration

Der Vault-Ordner — die einzige unverzichtbare „Datei”: deine Notizen sind die .md-Dateien darin; alles Dauerhafte (Typen, gespeicherte Ansichten, Anhänge) reist mit ihm.
type: im Frontmatter jeder Notiz — weist der Notiz ihren Typ zu; es ist der wichtigste Organisationshebel (Seitenleiste, Vorlagen und gepinnte Eigenschaften hängen davon ab).
Typ-Dokumente (type: Type) — definieren Icon, Farbe, Reihenfolge, gepinnte Eigenschaften und Vorlagen für neue Notizen; als Basis eignet sich das Kopieren des Vaults portent-vault-template.
config/relations.md und config/semantic-properties.md (laut VISION.md) — die Overrides der Standardkonventionen: welche Relationsfelder erscheinen und wie Eigenschaften gerendert werden.
Settings > Workflow / Settings > Vaults — den Inbox ein-/ausschalten bzw. das vereinheitlichte Multi-Vault aktivieren.

Häufige Fallstricke und Lösungen

Windows und Linux sind „Supported, early”. Zum Zeitpunkt dieser Recherche dokumentierte offene Issues: #1145 (Wikilinks [[]], die in der Windows-App nicht funktionieren), #1155 (unter Windows wird bei tabellenartigen Notizen der Titel zum vollständigen Dateipfad, und Zellbearbeitungen gehen verloren), #1077 (Drag & Drop von Dateien und Neuorganisieren von Ordnern funktioniert nicht).
Das Homebrew-Cask hat die falsche neueste Version angezeigt: Issue #1160 („Incorrect latest Tolaria version via Homebrew”). Auf der Releases-Seite prüfen, falls die Cask-Version veraltet wirkt.
#recycle-Ordner auf Synology-NAS: Issue #1159 — der Vault stürzt mit einem opdir-Fehler ab, wenn der Papierkorb-Ordner des NAS gescannt wird; die praktische Lösung ist, diesen NAS-Vault auszuschließen oder den Ordner zu löschen/umzubenennen.
Import aus Obsidian: Der Ablauf „den Ordner mit cp -a kopieren und als Vault öffnen” ist der de facto dokumentierte Weg (über Discussions und den HN-Thread), aber wkcheng meldete beim Show HN (100 % reproduzierbar): Nach dem ersten Git-Commit funktionierte die Sortierung nach „zuletzt geändert” nicht mehr; der Autor antwortete, er werde es untersuchen. Bei einem großen Vault-Import lohnt es sich, die Sortierung früh zu prüfen.
Die App schreibt Dateien um / seltsame MCP-Suche: Issue #1144 dokumentiert, dass Tolaria Dateien umschreibt, sowie ein MCP-Suchproblem; wenn ein externer Agent deine Änderungen nicht sieht, prüfe, ob die App sie nach dem Schreiben aktualisiert hat (MCP-Schreibvorgänge aktualisieren Tolaria, aber nicht immer umgekehrt).
Die mobile App ist experimentell: #1102 dokumentiert, dass die mobile App (apps/mobile, React Native) auf physischen iPads abstürzt — nicht nur im Simulator — wegen einer Tastaturbefehls-API, die nur in der Simulation verfügbar ist. Verlass dich nicht darauf für mobile Erfassung.
Die „Webwrapper”-Kritik: Mehrere HN-Nutzer bemängeln, dass Tauri ein Browser-Wrapper sei (ikdiendoehdj: „absolutely disgusting, either go native or don’t bother”). Die Antwort des Autors: Er begann in Swift und stieß auf reale Grenzen des Markdown-Editors; die differenzierteste technische Erwiderung kam von msephton (der einen iOS-Markdown-Editor mit 8-ms-Restyle baute). Wer sich davon blockiert fühlt, sollte die App vor der Entscheidung testen.
Linux: Ohne WebKit2GTK 4.1 + GTK 3 schlägt der Build fehl; und ohne installiertes node startet der MCP-Server im Flow für externe Tools nicht.

Integrationen und Migration

Coding-Agenten: Das KI-Panel integriert direkt Claude Code, Codex, GitHub Copilot, OpenCode, Pi, Antigravity CLI, Kiro und Hermes Agent (die auf dem Rechner installierten werden erkannt und nutzen ihre eigenen Credentials); die Modi Vault Safe / Power User begrenzen den Umfang.
MCP: mitgelieferter Server mit unterstützter Einrichtung für Claude Code, Cursor und Antigravity CLI, oder generisches JSON.
Browser: Die Community-Erweiterung feir/Save-To-Tolaria (Cmd/Ctrl+Shift+S) speichert Seiten als Notizen mit typbewusstem Frontmatter.
Migration von Obsidian/Logseq/Notion: den Markdown-Ordner direkt als Vault öffnen (Legacy-Obsidian-Vaults funktionieren; es gibt eine eigene Discussion, #391, zu Legacy-Vaults). Von Notion muss man zuerst nach Markdown exportieren.
Tolaria verlassen: Es gibt nichts zu migrieren — deine Dateien sind reines Markdown + Git; jeder Editor, grep oder jedes Versionskontrollsystem verarbeitet sie (das Prinzip „Zero Lock-in”, explizit im README und im VISION).

Zahlen zum Repo

Messung: 25. August 2026, GitHub-API.

Metrik	Wert
Sterne	19.584
Forks	1.360
Abonnenten (Benachrichtigungen)	51
Von der API angegebene offene Issues	55
Commits (Hauptbranch)	3.672
Hauptsprache	TypeScript
Lizenz	AGPL-3.0-or-later
Erstellung	14. Februar 2026
Letzter Push	24. August 2026
Letztes Stable-Release	v2026-08-19 (19. August 2026)
Neuestes Alpha-Release	alpha-v2026.8.24-alpha.0001 (24. August 2026)

Die wichtigsten von der API zurückgegebenen Contributor (von insgesamt 24): LucaRonin (3.409 Beiträge — praktisch die gesamte Entwicklung), github-actions[bot] (208), evolankakis (10), riipandi (5), the-jwoo (3), mvanhorn (3), AlessandroMason (3), oksusucha (3).

Vorbehalte: open_issues_count (55) der GitHub-API kann offene PRs einschließen, es ist keine reine Issue-Zahl. watchers_count spiegelt die Sternezahl; die tatsächliche Zahl der Benachrichtigungsabonnenten ist 51 (subscribers_count). Die Commit-Zahl (3.672) wurde aus dem Link-Paginierungs-Header der Commits-API abgeleitet (rel="last"). Die Releases-Liste zeigt tägliche Alpha-Tags; /releases/latest verweist auf das Stable v2026-08-19. Der auf tolaria.md zum Zeitpunkt der Abfrage sichtbare Sternezähler betrug 9.946 (ein gecachter Website-Wert, der der API hinterherhinkt).

Wie man beiträgt

CONTRIBUTING.md dokumentiert einen offenen, expliziten Prozess:

Wo was geteilt wird: Bugs → GitHub Issues (einschließlich Tolaria-Version, Betriebssystem, Reproduktionsschritten, erwartetem vs. tatsächlichem Verhalten und Screenshots, falls hilfreich); Ideen und Feature-Requests → Canny (https://tolaria.canny.io/), wo es sich lohnt, Bestehendes zu upvoten, bevor man es baut.
PRs willkommen, mit Regeln: kleine, fokussierte, leicht zu überprüfende PRs; kurze Erklärung von Problem und Lösung; keine unabhängigen Refactorings vermischen; bei großen Features zuerst Canny prüfen (mit „in progress” Markiertes vermeiden; mit „planned” Markiertes ist ein gutes Beitragsziel).
Dem Entwicklungsprozess von AGENTS.md folgen, der die Qualitätsdisziplin des Repos dokumentiert (auch von den KI-Agenten genutzt, die an der Codebasis arbeiten):
- Verpflichtendes TDD: rot → grün → refactor → commit, ein Zyklus pro Commit; bei Bugs zuerst ein fehlschlagender Regressionstest.
- Check-Suite bei jedem Push: pnpm lint && npx tsc --noEmit && pnpm test && pnpm test:coverage (Frontend ≥70 % Abdeckung) und cargo test && cargo llvm-cov ... --fail-under-lines 85 (Rust ≥85 %).
- CodeScene als Code-Health-Gate mit „Ratchet”-artigen Schwellenwerten (nur nach oben, in .codescene-thresholds); Codacy als Sicherheits-Gate mit Null-neue-Funde-Regel.
- Playwright für Kernabläufe (Vault öffnen, Notiz erstellen/speichern/löschen, Suche, Wikilink-Navigation, Commit/Push, Konfliktauflösung); die Smoke-Suite muss unter 5 Minuten bleiben.
- Lokalisierung: Der gesamte UI-Text lebt in src/lib/locales/en.json und wird mit pnpm l10n:translate in die Zielsprachen von lara.yaml übersetzt (bereits inklusive Polnisch).
- PostHog: Neue Features sollten Analytics-Events ausgeben (mit sicheren Metadaten, ohne PII oder Notizinhalt).
- ADRs in docs/adr/ für Architekturentscheidungen; Dokumentation (docs/ARCHITECTURE.md, docs/ABSTRACTIONS.md, docs/GETTING-STARTED.md) im selben Commit wie die Änderung aktualisiert.
- Maßgebliches CI/CD: CircleCI (.circleci/config.yml) besitzt die Validierung, die plattformübergreifenden Release-Builds sowie die Veröffentlichung auf GitHub Releases und GitHub Pages.

Hinweis: AGENTS.md beschreibt zudem den internen Workflow des Eigentümers (Direct-to-Main mit Commits alle 20–30 Minuten, Aufgabenverwaltung in Todoist, vom Owner genehmigte dokumentierte Ausnahmen) — das ist das Handbuch für seine eigenen Entwicklungs-Agenten, nicht der Branch-Flow, dem ein externer Beitragender folgen sollte, der PRs gemäß CONTRIBUTING.md öffnet.

Wie die Community es aufnahm

Der Haupt-Hacker-News-Thread ist 47882697 — „Show HN: Tolaria – Open-source macOS app to manage Markdown knowledge bases”, eingereicht von lucaronin am 23. April 2026, mit 318 Punkten und 142 Kommentaren. Es gibt einen kleineren zweiten Beitrag, die Seite tolaria.md, unter 47865031 (3 Punkte, 0 Kommentare, 22. April 2026).

Die Begeisterung, mit konkreten Namen und Argumenten:

johntopia (intensiver Obsidian-Nutzer): „gute Arbeit Luca, ich war Heavy-User von Obsidian, aber mir gefällt dein Inbox-Konzept sehr”.
r0bbie: nutzte Logseq, mochte aber die UI nie; „sauber und ich liebe den git-backed Ansatz”. Bat um Dark Mode.
Pym: „besser als das, was ich selbst für mich bauen wollte. Ich liebe die UI, ich liebe, dass es mit Tauri gebaut ist”.
ajbd: „das Prinzip ‘types as lenses, not schemas’ und der Fokus auf Struktur + Relationen stechen wirklich hervor”.
tarr1124 ordnet die Diskussion ein: Obsidian setzt voraus, „Mensch liest und kuratiert; Plugins verbessern optional”, während die AI-first-Kohorte (Tolaria, Sig und einige mehr) „davon ausgeht, dass die KI als erstklassiger Agent liest und schreibt”.
fiatpandas bat darum, die KI „live” im Vault arbeiten sehen zu können, „wie eine Google-Docs-Sitzung”; lucaronin antwortete, dass genau dafür Git-first da sei: „du kannst die KI als Git-Contributor konfigurieren und ihre Änderungen klar sehen”.
smadam9 (Autor von Sig): „du warst mir einen Tag voraus… die architektonische Überschneidung ist offensichtlich: macOS, reines Markdown, Git-versioniert, als Kontext für KI-Agenten konzipiert”.
crashabr erwähnte moment.dev, ein frühes Startup, das Live-Agentenpräsenz in Vaults umsetzt.

Die Kritik, ebenfalls konkret:

jryio (der dem Geiste nach meistgewählte Einwand): „nur ein weiteres wegwerfbares Stück Software, gepflegt von einer Person, das 80 % dessen tut, was andere Apps tun, aber schlechter. Maximale Lebensdauer 2 Jahre”. Erhielt entschiedene Erwiderungen: rglover („Bitte nimm das zurück. Du willst nicht in einer Welt leben, in der Einzelpersonen davon abgehalten werden, gute Dinge zu bauen”), lbreakjai, BirAdam („Wusstest du, dass das einmal GCC und Linux beschrieb?”).
kskzjsjdjw: „Eine verdammte Web-App? Buh. Nein danke”. droidjj erwiderte: „immerhin ist es Tauri”.
ikdiendoehdj (technische Kritik, wiederholt in mehreren Kommentar-Threads): „ein Webwrapper ist absolut widerlich, entweder nativ oder lass es bleiben”; bemängelte auch das Risiko des npm-Ökosystems. sdevonoes nuancierte: „es geht nicht um Geschwindigkeit, sondern um das npm-Ökosystem: ich versuche zu vermeiden, npm-Abhängigkeiten auf meinem persönlichen PC laufen zu lassen”. lucaronin antwortete, er habe in Swift begonnen, sei aber auf reale Grenzen des Markdown-Editors gestoßen, und dass „Tauri sehr schnell” sei.
antonkochubey: „Macht Obsidian nicht schon praktisch dasselbe?”. dragonfax: „irgendwie wusste ich nicht, dass Obsidian nicht Open Source ist”. lucaronin antwortete mit der Liste der Unterschiede (Typen und Relationen, Notion-artige UX, erstklassiges Git, KI-orientierte Designentscheidungen und vor allem: Open Source).
wkcheng meldete den Sortierungs-Bug nach dem Import eines Obsidian-Vaults und dem ersten Commit (100 % reproduzierbar: cp -a des Vaults → in Tolaria öffnen → „Restore Tolaria AI Guidance” → die Sortierung nach letzter Änderung bricht).
msephton: „ich würde alles in Kauf nehmen, wenn es eine native macOS-App wäre”.
enola-mag fragte nach Windows (im April war die App laut Show-HN-Titel eine „macOS app”; Windows/Linux sind inzwischen als „supported, early” veröffentlicht).

GitHub Discussions (der offizielle Community-Kanal): „iOS workflow” (#259, 12 Kommentare), „Does Tolaria have support for Tabs” (#300, 12 Kommentare), „Claude Code finished without returning a reply” (#389, 17 Kommentare), „Legacy Obsidian vaults: reveal note in folder” (#391, 2 Kommentare).

Video (YouTube-Suche am 25. August 2026): „Tolaria — The Markdown Knowledge Base Born For Claude Code” von Prism Labs (7:14, ~5.600 Aufrufe); „Tolaria: A Markdown Second Brain Built for the Claude Code Era” von AwesomeFOSS (~7.300 Aufrufe, vergleicht Tolaria vs. Obsidian vs. Notion); „Tolaria GitHub Setup Guide: Markdown Knowledge Bases for Version-Controlled Personal Knowledge” von Alex Hitt (8:11, ~531 Aufrufe, behandelt MCP, AutoGit, Tauri/React/Rust und Agent-Instruction-Files). Mehrere Nischen-Shorts bewerben es (2.400, 1.600 und 728 Aufrufe; „Stop letting Notion hold your notes hostage”, „I Finally Deleted Notion And Found The Ultimate Free Alternative”). Luca selbst veröffentlicht drei Loom-Walkthroughs im README: wie er seinen Workspace organisiert, seinen Inbox-Workflow und wie er Webressourcen speichert.

Reddit und Product Hunt: In dieser Recherche konnten keine Threads oder Launch-Seiten verifiziert werden (der JSON-Endpunkt von Reddit lieferte eine Anti-Bot-Seite, und PullPush indexierte keine relevanten Posts; Product Hunt blockierte die Abfrage hinter der Cloudflare-Verifizierung). Es werden keine Reaktionen abgeleitet, die die Quellen nicht zeigen.

Tolaria im Vergleich zu anderen Ansätzen

Projekt	Verifizierbare Überschneidung	Verifizierbarer Unterschied
Obsidian	Ein lokaler Markdown-Vault mit Wikilinks; beide arbeiten über denselben Dateien.	Obsidian ist nicht Open Source (darauf weisen `dragonfax` und `lucaronin` auf HN hin), sein Modell dreht sich um proprietäre Synchronisation, und Git ist ein Zusatz; Tolaria liefert eine eigene Methode (Typen, Relationen, Inbox) und erstklassiges Git, ohne Plugin-Ökosystem.
Notion	Ein reichhaltiger blockweiser Editor, „Notion-artige UX” (Eigenbeschreibung des VISION).	Notion ist SaaS mit proprietärem Format auf entfernten Servern; Tolaria ist lokale Dateien + Git, offline-first und kontofrei.
Logseq	Lokales PKM, Markdown, auf Power-User ausgerichtet.	Logseq ist ein Outliner mit eigenem Dateimodell; auf HN wechselte `r0bbie` wegen der UI und des git-backed Ansatzes zu Tolaria.
Zettlr	Ein Desktop-Markdown-Editor mit Schreibfokus.	Zettlr ist ein Editor (kein Vault mit Typen/Relationen oder integrierter KI); auf HN berichtet `morelikeborelax` von Abstürzen, wenn sich Markdown im Hintergrund ändert.
Typora	Ein WYSIWYG-Markdown-Editor (von `astrocat` auf HN vorgeschlagen für alle, die „Bear-Notes-Politur” über reinem Markdown wollen).	Ein einfacher Editor, kein Notizgraph, kein Git, keine KI-Agenten.
Sig (`sig-ai-app/sig-releases`, 82 Sterne)	macOS, reines Markdown, Git-versioniert, Kontext für KI-Agenten (laut eigenem HN-Kommentar derselbe architektonische Autor).	Startet vom Team-Arbeits-Workflow aus (Commits in ein gemeinsames zentrales Repo) statt bestehendes Wissen zu organisieren.
rill (`rillmd/rill`, 6 Sterne)	Ein Markdown- + Git-Vault mit einer Schicht über Claude Code.	Fügt Sprach-Journaling und Wissensdestillation hinzu; hat nicht das Typen-/Relationen-Framework.

Der beim Launch am häufigsten gezogene Vergleich war der mit Obsidian (antonkochubeys Frage); die offizielle Antwort des Autors und des VISION ist philosophisch: Obsidian ist eine unendlich konfigurierbare leere Leinwand; Tolaria ist opinionated, mit Git als Kollaborationsschicht und KI als erstklassigem Mitarbeiter.

Anwendungsfälle

Autoren und Ersteller technischer Inhalte (der Fall des Autors selbst: 300+ Artikel, getragen von einem Vault mit 10.000+ Notizen). Der dokumentierte Ablauf „Erfassung → Evergreen-Notizen → Artikel” und das Inbox-Zero-Konzept ergeben eine vollständige Methode, nicht nur einen Editor; das VISION dokumentiert explizit, dass der Output von Autoren Artikel sind und Evergreen-Notizen die wiederverwendbare Zwischenschicht.
Entwickler, die täglich Coding-Agenten betreiben (Claude Code, Codex, Copilot, OpenCode, Kiro, Antigravity, Hermes Agent). Tolaria gibt ihnen persistenten, navigierbaren Kontext für ihre Agenten: einen MCP-Server mit mtime-geschützten Schreibvorgängen, Vault-Safe-/Power-User-Modi, eine AGENTS.md-Datei im Vault für Agentenanweisungen und Git als Auditschicht für KI-Änderungen (Diffs, Historie, Rollback) — das Muster „Agent committet als Git-Contributor”, das der Autor auf HN verteidigt.
Kleine Teams, die ihr Produkt als KI-Kontext dokumentieren wollen. Das VISION beschreibt Stufe 3 (Teams): dieselbe Ontologie (Projekte, Verantwortlichkeiten, Abläufe, Personen) skaliert, mit Workspace-Filterung und Zugriffskontrolle via Git; das README erklärt ausdrücklich „Unternehmensdokumentation als Kontext für KI organisieren”.
Notion-Umsteiger, die lokale Eigentümerschaft über ihre Daten wollen. Offline-first, kontofrei, abofrei, durch Konstruktion exportierbare flache Dateien; das VISION richtet sich direkt an Menschen, die „von Notions Leistung, Komplexität oder Lock-in frustriert sind” und mit Git vertraut sind.
Obsidian-Nutzer, die Struktur ohne Plugin-Jagd wollen. Der bestehende Vault wird direkt geöffnet (Discussion #391 zu Legacy-Vaults), und man gewinnt das Typen-/Relationen-/Inbox-Framework mit Standardkonventionen, erstklassigem Git und Open Source — ohne das Plugin-Ökosystem.
Erbauer von Agenten/Assistenten, die persistentes Gedächtnis brauchen. Das README erklärt „store OpenClaw/assistants memory and procedures”; die Kombination aus Markdown-Vault + Git + MCP + Portent (eine Spezifikation für Typen und Lebenszyklus) ist eine sowohl für Menschen als auch für Agenten lesbare Basis, wobei die portent-Spezifikation ausdrücklich darauf ausgelegt ist, auf andere Systeme portierbar zu sein.
Tastatur-Power-User. Command Palette (Cmd/Ctrl+K), dokumentierte Shortcuts und ein als Prinzip erklärtes „keyboard-first”-Design; die App lässt sich fast vollständig ohne Maus bedienen.

Ressourcen

Repository: https://github.com/refactoringhq/tolaria
Offizielle Seite / Dokumentation: https://tolaria.md (Docs im site/-Ordner des Repos, veröffentlicht auf GitHub Pages; beginnen mit site/start/install.md und site/start/first-launch.md)
Downloads: https://tolaria.md/download/ · Releases: https://github.com/refactoringhq/tolaria/releases · Release-Notizen: Ordner release-notes/ des Repos
Homebrew: Cask tolaria (brew install --cask tolaria)
Repositories der Organisation: refactoringhq/portent (Spezifikation, https://portent.md) · refactoringhq/portent-vault-template · refactoringhq/tolaria-getting-started
Offizielle Walkthroughs (Loom, vom Autor): How I Organize My Own Tolaria Workspace · My Inbox Workflow · How I Save Web Resources to Tolaria
Video (YouTube): „Tolaria — The Markdown Knowledge Base Born For Claude Code” (Prism Labs) · „Tolaria: A Markdown Second Brain Built for the Claude Code Era” (AwesomeFOSS) · „Tolaria GitHub Setup Guide” (Alex Hitt) — Aufrufzahlen siehe Abschnitt zur Rezeption
Relevante HN-Threads: 47882697 (Show HN, 318 Punkte, 142 Kommentare) · 47865031
Community: GitHub Discussions · Canny (Feature-Requests) (in den konsultierten Quellen wurde kein Discord-Server verifiziert)
Entwickler-Docs: docs/GETTING-STARTED.md, docs/ARCHITECTURE.md, docs/ABSTRACTIONS.md, docs/adr/, AGENTS.md
Chinesische Übersetzung: primitiver/tolaria-zh · Chrome-Erweiterung: feir/Save-To-Tolaria

Dieser Artikel kombiniert das README, CONTRIBUTING.md, AGENTS.md, docs/VISION.md und die Nutzerdokumentation im site/-Ordner des Repositorys, Schwester-Repos der Organisation refactoringhq, die GitHub-API (Metriken, Releases, Contributor, Issues, Discussions), die Homebrew-Formulae-API, den vollständigen Hacker-News-Thread 47882697, die Seite tolaria.md und eine YouTube-Suche, abgerufen am 25. August 2026. Stern- und Fork-Zahlen der begleitenden Repositories ändern sich mit der Zeit. In dieser Recherche konnten keine Reddit-Threads oder eine Product-Hunt-Seite verifiziert werden (Anti-Bot-Blockade); sie werden ausgelassen statt abgeleitet.