Kaveyl English
Funktionen

Alles, was Kaveyl Wiki kann

Alles ist eingebaut – keine Plugins zum Zusammensuchen. Hier steht nur, was es wirklich gibt; Einzelheiten zu jedem Punkt stehen im Handbuch, das in Kaveyl Wiki eingebaut ist (F1).

Grundsätze

  • Notizen sind normale Markdown-Dateien in Git-Repositories oder Ordnern, eine eigene Datenbank für Inhalte gibt es nicht
  • Beim Speichern ändern sich nur die Abschnitte, die du bearbeitet hast; der Rest bleibt Byte für Byte gleich
  • Bloßes Öffnen ändert nie etwas
  • Nichts wird still überschrieben – bei gleichzeitigen Änderungen gibt es einen Hinweis bzw. Konflikt-Dialog
  • Was Kaveyl Wiki schreibt (Hinweis-Boxen, Bildgrößen, Links), sieht in Gitea, GitHub und VS Code genauso aus
  • Unter jeder Quelle liegt Git – auch lokale Ordner bekommen auf Wunsch eigene Versionen

Schreiben & Editor

  • Editor mit sichtbarer Formatierung oder Markdown-Quelltext, je Notiz umschaltbar
  • Formatierungsleiste mit Überschriften, Listen, Checklisten, Zitaten, Codeblöcken und Tabellen (Zeilen und Spalten einfügen oder löschen)
  • Slash-Befehle mit / (deutsch oder englisch) und ein Auswahlmenü für markierten Text
  • Hinweis-Boxen (Hinweis, Tipp, Wichtig, Warnung, Vorsicht) und aufklappbare Blöcke
  • Codeblöcke mit Farbhervorhebung; die Sprache erkennt Kaveyl Wiki auch selbst
  • Formeln (LaTeX mit KaTeX) und Diagramme mit Mermaid – Ablauf, Zeitleiste, Mindmap, Torte, Projektplan, Git-Verlauf
  • Zeichnungen mit Excalidraw, gespeichert als SVG neben der Notiz und später weiter bearbeitbar
  • Dateien und Bilder per Büroklammer, Ziehen oder Einfügen anhängen; sie liegen im Ordner assets/ neben der Notiz
  • Bilder ausrichten und skalieren; große Fotos werden beim Einfügen als WebP verkleinert, GPS- und Kameradaten fallen weg
  • Notizen mit [[ verlinken – es entsteht ein normaler relativer Link
  • Emoji mit : und Format übertragen mit dem Pinsel
  • Speichert automatisch kurz nach dem Tippen; was der Editor nicht darstellen kann (HTML, Fußnoten), bleibt unverändert erhalten

Organisieren

  • Jede Quelle als eigener Baum in der Seitenleiste, dazu Favoriten und „Zuletzt“ (geöffnet oder geändert)
  • Tabs, angeheftete Tabs und eine geteilte Ansicht mit zwei Notizen nebeneinander
  • Umbenennen und Verschieben – auch in eine andere Quelle – mit automatischer Link-Reparatur
  • Kopieren, Ausschneiden und Einfügen im Baum, auch zwischen Quellen, mit Bildern und Anhängen
  • Ziehen und Ablegen zum Verschieben und Sortieren; die Reihenfolge gilt für alle
  • Mehrere Notizen und Ordner markieren und gemeinsam verschieben, exportieren, löschen oder teilen
  • Vorlagen mit Platzhaltern für Titel, Datum, Uhrzeit und Namen
  • Tags mit Vorschlägen, zwölf Farben und Umbenennen oder Zusammenführen über alle Quellen
  • Icons für Notizen und Ordner: rund 1 900 Symbole, Emoji oder eigene hochgeladene Bilder
  • Fokus auf einen Ordner und alles auf- oder zuklappen
  • Schreibschutz für einzelne Notizen

Finden

  • Sofort-Suche (Strg+P) mit Treffern beim Tippen, gruppiert nach Ordnern, Notizen und Inhalt
  • Such-Seite mit Filtern für Quelle, Tag, Ordner und Änderungsdatum
  • Suchbefehle wie tag:, in:, path:, seit:, genaue Phrase und -wort
  • Findet ganze Wörter, Wortanfänge und Teilwörter
  • Befehlspalette (Strg+K) für Notizen und Befehle
  • „Verlinkt von“ zeigt unter jeder Notiz, wer auf sie verweist
  • Vorschau beim Überfahren eines Notiz-Links
  • Inhaltsverzeichnis neben der Notiz
  • Links ins Leere sind schon beim Schreiben rot markiert, mit „Notiz anlegen“

Quellen & Git-Abgleich

  • Beliebig viele Quellen: Gitea, GitHub, GitLab, jede Git-Adresse (HTTPS) und lokale Ordner
  • Assistent zum Einbinden: Branch wählen, ganzes Repository oder nur einzelne Ordner und Dateien
  • Neue Repositories bei Gitea direkt aus Kaveyl Wiki anlegen (privat als Standard)
  • Lokale Ordner mit eigenem Git: Versionen, Papierkorb und wer was geändert hat – ohne Git-Server
  • Gespeichertes wird zu Commits mit dir als Autor und automatisch übertragen; Pause einstellbar, Strg+S sofort
  • Holt Änderungen alle 5 Minuten oder sofort per Push-Webhook; bei Gitea richtet Kaveyl Wiki den Webhook auf Klick ein
  • Arbeitet mit VS Code, Obsidian (Git-Plugin), Wiki.js und git zusammen; Umbenennungen von außen werden erkannt und Links repariert
  • Änderungen an verschiedenen Stellen derselben Notiz führt der Abgleich von selbst zusammen, ohne Merge-Commits
  • Gemeinsamer Ordner mit einem anderen Programm: Änderungen erscheinen nach etwa einer Sekunde
  • Sync-Symbol und Sync-Übersicht mit Verlauf je Quelle und „Jetzt synchronisieren“
  • Mehrere Verbindungen (Konten, auch mehrere Gitea-Instanzen); Token prüfen, der gespeicherte Token wird nie angezeigt
  • Gitea-Repositories über einen Papierkorb löschen: archiviert, 30 Tage wiederherstellbar, vorher als Git-Bundle gesichert

Zusammenarbeit

  • Du siehst, wer eine Notiz offen hat und wer gerade tippt
  • Fängst du an zu tippen, während jemand anderes bearbeitet, fragt Kaveyl Wiki einmal nach
  • Speichert jemand anderes, siehst du die Änderung sofort – Cursor und Leseposition bleiben
  • Wird eine offene Notiz verschoben oder umbenannt, folgt dein Tab ihr
  • Hinweis „außerhalb geändert“ mit „Zusammenführen“ per Klick, Unterschieden und Wahl der Fassung
  • Konflikte lösen mit drei Fassungen nebeneinander (Basis, meine, fremde) oder von Hand
  • Jede Person bekommt ihre eigene Version; Mitbearbeiter stehen als Co-Autoren dabei
  • Notizen, Ordner oder Quellen beobachten: Punkt in der Seitenleiste und Liste „Neu für dich“
  • Beobachtetes per E-Mail (gebündelt, stündlich oder täglich) oder Pushover
  • Auch Änderungen von außen (Git, VS Code, Programme) werden gemeldet, als „von außen“

Versionen, Papierkorb, Wiederherstellen

  • Versionen jeder Notiz aus der Git-Historie, auch über Umbenennungen hinweg, mit Unterschieden
  • Alte Version wiederherstellen – als neue Änderung, die Historie bleibt vollständig
  • „Speichern als“ legt eine alte Version als neue Notiz ab, mit ihren Bildern; überschrieben wird nie
  • Papierkorb je Quelle; ein gelöschter Ordner ist ein Eintrag, ganz oder einzeln zurückzuholen
  • Gelöschtes steht sofort im Papierkorb, auch eine eben erst angelegte Notiz
  • „Wiederherstellen“ direkt in der Meldung nach dem Löschen
  • Aufbewahrung einstellbar (Standard 30 Tage); die Git-Historie wird nie umgeschrieben
  • Ungespeicherte Eingaben bleiben bei Abmeldung oder Serverausfall im Tab und werden danach gespeichert

Rechte, Konten, Teilen

  • Rollen Administrator, Benutzer und Gast
  • Rechte je Quelle, Ordner oder Notiz: kein Zugriff, lesen, lesen & schreiben, verwalten
  • Regeln für alle, für Gruppen oder einzelne Personen; die genaueste Regel gewinnt
  • Rechte-Raster mit Personen und Quellen auf einen Blick, mit geerbten Rechten und Aufräum-Vorschlägen
  • Neue Benutzer sehen erst, was freigegeben ist
  • Konten per Einladungs-Mail oder mit Startpasswort anlegen, auf Wunsch mit Pflicht zum Ändern
  • Gruppen anlegen und Mitglieder per Häkchen zuordnen
  • Zugriff per E-Mail geben auf Notiz, Ordner oder Quelle; neue Personen bekommen ein Gast-Konto
  • Notizen per Mail als .md-Datei an Leute ohne Konto schicken – ohne Link ins Wiki
  • Konten sperren, entsperren und löschen; Sperren meldet sofort überall ab
  • Die Rechte gelten genauso für REST-API und MCP

Verschlüsselung

  • Einzelne Notizen mit einer Passphrase verschlüsseln – im Browser, mit dem offenen Format age
  • Verlinkte Bilder und Dateien werden mit verschlüsselt
  • Ganze Ordner verschlüsseln; neue Notizen darin werden automatisch verschlüsselt
  • Server, Git und VS Code sehen nur den verschlüsselten Block; Kaveyl Wiki speichert keinen Schlüssel
  • Automatisch wieder sperren nach 5, 15, 30 oder 60 Minuten, oder sofort
  • Lässt sich auch ohne Kaveyl Wiki mit dem Programm age entschlüsseln
  • Die Prüfung findet unverschlüsselte Notizen in verschlüsselten Ordnern; „Ordner fertig verschlüsseln“ holt sie nach
  • Die KI bekommt verschlüsselte Notizen nie zu sehen

Backup & Wiederherstellung

  • Sicherungen der Quellen und der Datenbank auf eine SMB-Freigabe (NAS, Windows) oder einen eigenen Backup-Ordner
  • Je Quelle eine ZIP-Datei, die sich auch ohne Kaveyl Wiki öffnen lässt; lokale Ordner mit ihrem Verlauf
  • Auf Wunsch mit Backup-Passwort AES-256-verschlüsselt (öffnen z. B. mit 7-Zip)
  • Zeitpläne täglich, wöchentlich, monatlich, jährlich mit „behalten“; verpasste Läufe werden nachgeholt
  • Ziel vor dem Speichern testen – mit Probedatei und freiem Platz
  • Sicherung öffnen und mit dem jetzigen Stand vergleichen; einzelne Absätze zurückholen
  • Einzelne Notizen, Ordner oder die ganze Quelle zurückspielen oder als Kopie speichern
  • „Aus Backup wiederherstellen“ direkt per Rechtsklick im Baum
  • Vorhandene Sicherungen auf einem Ziel werden gefunden und eingelesen
  • Neuer Server: Datenbank in der Ersteinrichtung zurückspielen – mit allen Konten, Rechten, Quellen und Zeitplänen
  • Nächtliche Sicherung der Datenbank im Container (7 tägliche, 4 wöchentliche)
  • Meldung, wenn eine Sicherung fehlschlägt

Import & Export

  • Markdown-Dateien vom Computer als Notizen importieren, ohne etwas zu überschreiben
  • Import aus anderen Programmen als ZIP (bis 500 MB) mit Vorschau vor dem Schreiben
  • Unterstützt: HedgeDoc (auch CodiMD), Joplin, Logseq 0.10, SilverBullet, Obsidian, Outline, Trilium, Wiki.js 2.x und Markdown-Ordner
  • Jeder Import landet in einem neuen Ordner mit Import-Bericht; Links zeigen auf die neuen Namen
  • Bei HedgeDoc holt Kaveyl Wiki die Bilder vom alten Server
  • Wikis, die schon in Git liegen (Gollum, Wikis von Gitea/GitHub/GitLab, MkDocs, Docusaurus), direkt als Quelle einbinden
  • Export als HTML: eine Notiz als Datei mit eingebetteten Bildern, Ordner oder Quelle als ZIP mit Übersicht
  • Export als Markdown, Byte für Byte wie in der Quelle, mit Bildern und Ordnerstruktur
  • Knopf „Herunterladen“ in jeder Notiz; mehrere markierte kommen in ein ZIP
  • Drucken und PDF mit einer sauberen Seite ohne Seitenleiste

KI-Assistent

  • Anbieter: Ollama (lokal), Ollama Cloud, Anthropic, OpenRouter und OpenAI-kompatible Dienste; mehrere gleichzeitig
  • Die KI sieht nichts, bis ein Admin Quellen, Ordner oder Notizen freigibt; Ausnahmen sperren gezielt
  • Freigabe „nur für KI im eigenen Netz“, wenn lokale und Cloud-KI eingerichtet sind; Cloud-Anbieter sind gekennzeichnet
  • Im Editor: umformulieren, kürzen, ausbauen, Rechtschreibung, übersetzen, zusammenfassen, weiterschreiben
  • Fragen an die Wissensbasis: die KI sucht und liest selbst und nennt die Notizen, auf die sie sich stützt
  • Die KI ändert nie selbst: Änderungen kommen als Vorschläge mit Vorschau, du übernimmst oder verwirfst
  • Antworten formatiert kopieren oder als neue Notiz speichern
  • Eigener Anbieter und persönliche Anweisungen je Benutzer
  • KI-Gedächtnis je Quelle als Markdown im Repository
  • Chats mit Aufbewahrungsfrist (Standard 90 Tage, je Quelle anders) und „Verlauf löschen“
  • Jede Anfrage steht im Protokoll – wer, welches Modell, welche Notizen, ohne Inhalte

API, MCP & Agenten

  • REST-API v1 mit OpenAPI-Beschreibung (z. B. für Postman oder Bruno)
  • Eingebauter MCP-Server für Claude Code, Cursor, VS Code, LM Studio, Hermes und andere MCP-Clients
  • Über MCP: suchen, lesen, schreiben, anlegen, kopieren, verschieben, löschen, Dateien hochladen, Versionen und Abgleich
  • Persönliche Tokens mit Rechten lesen, schreiben, MCP, verwalten und Ablaufdatum; erneuern oder löschen
  • Nach dem Erstellen gibt es den fertigen Befehl für Claude Code und eine JSON-Konfiguration zum Kopieren
  • Gleiche Rechte wie in der App; Änderungen stehen mit dem Token-Inhaber als Autor in Git
  • Schutz vor Überschreiben: geschrieben wird mit dem gelesenen Stand, sonst kommt ein Konflikt
  • Ereignisse für Agenten: was sich geändert hat und wer es war, per Abfrage mit Warten
  • Ereignis-Webhooks schicken Änderungen sofort und signiert an andere Systeme
  • Admins legen Tokens für Agenten-Konten an, ohne sich als Agent anzumelden
  • Beispiel-Agent zum Herunterladen: macht aus Server-Warnungen Vorfall-Notizen, handelt erst nach Freigabe durch Menschen

Anmeldung, SSO & Netz

  • Anmeldung mit E-Mail und Passwort, auf Wunsch 30 Tage angemeldet bleiben
  • „Passwort vergessen?“ mit Link per E-Mail
  • Passwortregeln nach NIST SP 800-63B-4: lange Passwörter, leicht zu erratende werden abgelehnt
  • Bremse gegen das Durchprobieren von Passwörtern
  • Einrichtungscode beim ersten Start, damit niemand die Instanz übernimmt
  • Anmeldung über Cloudflare Access ohne zweites Passwort
  • Läuft hinter einem Reverse-Proxy mit https (z. B. Nginx Proxy Manager); eine Seite zeigt, ob Proxy, https und Live-Verbindung stimmen
  • Vertrauenswürdige Proxys festlegbar, damit Protokoll und Anmeldebremse die echte Adresse sehen
  • In Git erscheint nur der Name, nie die E-Mail-Adresse

Betrieb & Wartung

  • Läuft als Docker-Container, freie Software unter der AGPL-3.0
  • Protokoll mit Filtern nach Art, Quelle, Problemen und Person – nie mit Passwörtern, Tokens oder Notizinhalten
  • Aufräumen an einer Stelle: Löschregeln für alles, was wächst, mit aktuellem Stand und „Jetzt aufräumen“
  • Nächtliche Prüfung: gebrochene Links, doppelte IDs, verwaiste Anhänge, unverschlüsselte Notizen in verschlüsselten Ordnern
  • Meldungen an Admins per E-Mail oder Pushover: Sync-Probleme, Nachtlauf, Backup, Sicherheit, knapper Speicherplatz
  • Schutz vor Nachrichtenflut (Pausen je Meldung, höchstens 10 je Stunde)
  • Hinweis für Admins, wenn eine neue Version erschienen ist; Sicherheitsupdates rot
  • Größte Dateigröße, gesperrte Dateiendungen und Verkleinern großer Bilder einstellbar
  • Zugangsdaten verschlüsselt gespeichert (AES-256-GCM), Passwörter als scrypt-Prüfsumme
  • Willkommensseite mit ersten Schritten je Rolle, Erledigtes ist abgehakt

Überall

  • Web-App für jeden Browser, ohne Installation
  • Wie eine App ablegen auf Handy, Tablet und Computer (über https)
  • Auf dem Handy: Seitenleiste als Schublade, wischbare Formatierungsleiste
  • Alles per Touch bedienbar – langes Drücken öffnet das Kontextmenü, nichts nur per Maus
  • Oberfläche auf Deutsch und Englisch, je Konto; auch Server-Meldungen und E-Mails
  • Hell, Dunkel oder wie das Gerät
  • Schriftgröße für Oberfläche, Seitenleiste, Notiztext und Code getrennt (80–150 %); Editorbreite einstellbar
  • Handbuch in der App mit Suche; F1 öffnet die Hilfe zur aktuellen Stelle
  • Tastenkürzel und vollständige Bedienung des Baums mit der Tastatur
Bilder

So sieht es aus

Ein Reiseplan mit Tagestabelle, Packliste als Checkliste und Hinweis im dunklen Modus
Dunkler Modus
Das Apfelstrudel-Rezept am Handy
Am Handy, als installierte App
In der Praxis

Ein Wiki, von beiden Seiten gesehen

Dieselben Notizen, ob du klickst oder programmierst.

 Im AlltagEntwickler & KI-Agent
StrukturOrdner mit Ziehen und AblegenEin einfacher Verzeichnisbaum im Repository
SchreibenEditor im Browser, Formatierung beim TippenVS Code, Neovim, git, MCP oder REST-API
VerlaufVersionen je Notiz, ein Klick zum WiederherstellenGit-Commits und Diffs, mit Namen
KIDen Assistenten zu deinen Notizen fragenMCP-Werkzeuge zum Suchen, Lesen und Schreiben
SpeicherDein eigener Server – nichts in fremder CloudMarkdown in Git – im Repository oder in einem Ordner auf dem Server