AKA Recht

Ein Strafzettel, eine Kündigung, eine Nebenkostenabrechnung, ein Bescheid vom Amt, Strafanzeige, Widerspruch: Irgendwann hat jeder eine Rechtssache, und dann liegen Briefe, Fotos, Mails und Fristen überall. AKA Recht ist der Ordner, in dem das alles seinen Platz findet, und die Anleitung, mit der deine KI dir hilft, es zu ordnen, zu prüfen und zu formulieren.

AKA Recht hilft dir, Rechtssachen wie Kündigungen, Bußgelder, Strafanzeige, Widerspruch oder Mietstreitigkeiten selbst zu ordnen. Deine Akten liegen lokal auf deinem Rechner, ohne Cloud-Speicher. Jeder Fall hat eine eindeutige Kennung und eine feste Struktur für Dokumente, Beteiligte, Fristen und Verlauf. Digitale Fingerabdrücke (Prüfsummen) machen Dateiveränderungen erkennbar.

Das Fristende wird nach §§ 187, 188 und 193 BGB berechnet, unter Berücksichtigung von Wochenenden und den landesweiten Feiertagen des maßgeblichen Bundeslands (nach § 193 BGB das des Erklärungs- oder Leistungsorts). Welche Frist gilt und wann sie beginnt, musst du selbst klären.

Über die KI-Schnittstelle MCP lassen sich Akten durchsuchen, Dokumente auswerten und Schreiben entwerfen. Dabei wird alles, was der KI-Assistent aus der Akte liest, an den jeweiligen KI-Anbieter übermittelt. Änderungen an der Akte erfolgen nur nach deiner ausdrücklichen Bestätigung.

AKA Recht ersetzt keine Rechtsberatung.

• Jede Sache ist ein Fall mit fester Kennung, festen Ordnern, Ordnungsdaten in akte.json und einem Journal. Originale werden nie verändert.

• Fristen mit Rechnung: Jede Frist zeigt Auslöser, Rechtsgrundlage und den Rechenweg nach §§ 187, 188, 193 BGB, mit den Feiertagen deines Bundeslands.

• Chronologie, der auch andere folgen können: ein Zeitpfad mit der Zeit in der Mitte, links die anderen Stellen, rechts deine eigenen Schritte. Kernereignisse auf einen Klick, Farbe je Gruppe, Anlass und Reaktion mit Abstand („7 Tage später“), und jede Fundstelle öffnet das Dokument.

• Deine KI arbeitet mit: Claude Code, Claude Desktop, Codex oder jede andere, die MCP (Model Context Protocol) oder Befehle ausführen kann. 7 Anleitungen führen sie von der Fallaufnahme bis zum geprüften Entwurf, 36 Werkzeuge lassen sie in der Akte lesen und, nach deiner Bestätigung, schreiben.

• Alles bleibt bei dir: keine KI in der App, kein Konto, kein API-Schlüssel, kein Netz. Der Dienst läuft nur auf deinem Rechner.

Feste Version 0.4 vom 18.09.2026 · neuester Quellstand vom 08.10.2026 · Datenformat akte.json Schema 1 · MCP-Protokoll 2026-07-28 und 2025-11-25 · Autor: Hasan Tepegöz

Neu seit Version 0.4

Diese Punkte stehen im neuesten Stand vom 08.10.2026, noch nicht in der festen Version 0.4. Für diese Änderungen den neuesten Stand über „Code → Download ZIP“ oder git laden. Die feste Version auf der Release-Seite bleibt 0.4. Der aktuelle Prüfstand und die offenen Grenzen stehen direkt unter den Neuerungen.

• Einmalige Startlinks: Jeder Start öffnet einen neuen Link, der zwei Minuten und nur einmal gilt. Die Browseranmeldung bleibt davon getrennt; erneutes Öffnen lässt vorhandene Fenster angemeldet. Mit server.py --stop lässt sich gezielt der Dienst dieser Mappe beenden.

• Vollständige Dokumentationsansichten: Der Generator und die automatische Doku-Prüfung erfassen Markdown-Quellen auch in Unterordnern. Die HTML-Ansichten haben passende relative Links; interne Arbeitsstände bleiben aus der öffentlichen Navigation ausgeschlossen.

• Stabile Kennungen: Auch beim vollständigen Speichern bleiben bekannte frühere Nummern erhalten. Niedrigere Zähler werden abgewiesen, fehlende aus dem gespeicherten Stand ergänzt; entfernte Einträge geben ihre Nummer dadurch nicht wieder frei.

• Frische Prüfsummen: Ausdrückliche Bestands- und Sicherungsprüfungen lesen den aktuellen Dateiinhalt neu, auch bei gleicher Größe und gleichem Änderungsdatum. Die Seite „Bestand und Sicherung“ prüft beide Archive beim Öffnen frisch; die schnelle Übersicht behält ihren Zwischenspeicher.

• Dokumentvorschau beim Wechsel: Verspätete Textantworten und Fehlermeldungen überschreiben nach einem Wechsel des Dokuments, Reiters oder Falls nicht mehr die aktuelle Vorschau. Auch Schließen und Zurückwechseln sind abgesichert. Mit 13 Browserprüfungen auf macOS geprüft; Linux und Windows stehen noch aus.

• Erster Start und Zahlenprüfung: Der erste Start blockiert die Einrichtung nicht mehr; gleichzeitige Starter verwenden einen Dienst. Ungültige Zahlen wie NaN oder Unendlich werden über Oberfläche, Befehlszeile und KI-Schnittstelle vor dem Speichern abgewiesen. Geprüft mit künstlichen Akten auf macOS; Linux und Windows stehen für diese Änderungen noch aus.

• Chronologie als Zeitpfad: links die anderen Stellen, rechts die eigenen Schritte, die Zeit in der Mitte; Kernereignisse, Farbe je Gruppe, Bezug „Antwort auf“ mit Abstand, eigene Art eines Ereignisses neben der Liste der üblichen.

• Beteiligte mit Rolle und Funktion: Die Rolle ordnet der Gruppe zu und bestimmt Seite und Farbe in der Chronologie; die Funktion sagt in freien Worten, wer jemand ist, etwa „Rechtsanwalt der Gegenseite“.

• Entwürfe: Die Fassungsnummer folgt dem Text: Unveränderter Text behält die Nummer, wenn sein Status wechselt, geänderter bekommt eine neue. Auch bei erneutem Erfassen einer bereits festgehaltenen Fassung wird der aktuelle Status gesetzt; Historie und Kopien bleiben erhalten. Ein Entwurf lässt sich umbenennen (entwurf_setzen).

• Bestand: Werkzeuge, die selbst eine Datei anlegen, geben nur dieser eine Kennung; andere neue Dateien bleiben unerfasst, bis du bestand_abgleichen aufrufst.

• Sicherung: Die Wiederherstellungsprobe meldet getrennt, ob das Archiv vollständig ist und ob jede Akte alle Regeln des Datenmodells erfüllt. Sicherungsziele werden vor dem Speichern auf gültige Ordnerpfade außerhalb des Projekts geprüft; fehlerhafte Eingaben ändern keine Einstellungen. Ein zweites Ziel ist ab Werk leer: Ob eine Sicherung in einen Cloud-Ordner geht, entscheidest du in den Einstellungen.

• Eigene Texte sind kein Original: Was eine KI über datei_ablegen anlegt, bekommt den Stand Entwurf oder Vermerk, auch im Eingang. Das Übergabepaket nimmt solche Texte nicht als Original mit; für die Gegenseite stehen darin weder Falltitel noch eigene Dokumenttitel.

• Verlässlicher bei gleichzeitiger Arbeit: Oberfläche, Befehlszeile und KI können gleichzeitig Fälle anlegen und Einstellungen speichern, ohne dass ein Fall aus dem Verzeichnis fällt; ein Fallordner ohne Eintrag wird beim Sitzungsstart gemeldet. Ein Tippfehler in einer Dokumentkennung registriert keine fremden Dateien mehr.

• Schutz: Eine Python-Fassung vor 3.12 wird beim Start deutlich gemeldet, statt dass einzelne Teile still ausfallen. Der Word-Erzeuger überschreibt keine vorhandene Datei (--ersetzen für eine bewusste Neufassung) und schreibt nie in die Originalbereiche. Alte Office-Dateien (.doc, .xls, .ppt) werden nur im Dateimanager gezeigt. Sperr- und Laufzeitdateien liegen in einem eigenen Ordner des Benutzers.

• Sitzungsstart: Die Meldung des Hooks nennt ihre Uhrzeit; Verknüpfungen im Eingang zählen nicht als Post.

• Rechtsinhalte: Ein Prüflauf stellt sicher, dass alle Verweise der Merkblätter, des Quellenkatalogs und der Vorlagen auf amtliche Stellen zeigen.

Related MCP server: AI Legal Watch MCP

Prüfstand und bekannte Grenzen

Am 08.10.2026 sind 99 von 99 automatischen Prüfpunkten mit künstlichen Akten auf macOS 26.7.1 und Python 3.14.7 bestanden. Hinzu kommen gezielte Browserprüfungen der Dokumentvorschau, Sicherungsanzeige, Dokumentationsnavigation und einmaligen Startlinks. Neun der zehn Befunde des Nachaudits vom selben Tag sind behoben.

Für Linux und Windows ist der letzte gemeldete Stand 77 Prüfpunkte und Bedienprüfung vom 02.10.2026. Die 22 später hinzugekommenen Punkte und erweiterte bestehende Prüfungen stehen dort noch aus. Eine vollständige Abnahme des aktuellen Stands auf allen drei Systemen ist damit offen.

• Windows-Start (offener Auditpunkt 10): Start.bat verändert weiterhin drei mitgelieferte KI-Konfigurationen. In einer git-Arbeitskopie kann das Aktualisieren blockieren. Die Korrektur steht noch aus; eigene Änderungen vor dem Aktualisieren prüfen und erhalten, siehe Aktualisieren.

• Fallverwaltung: Ganze Fälle lassen sich noch nicht archivieren oder entfernen. Das ist geplant; ein Fallordner sollte nicht von Hand entfernt werden.

• Dateiformate: CSV wird bereits als Text gelesen. Für Excel (.xlsx) und Kalender (.ics) fehlt die Textvorschau noch.

• KI-Schnittstelle: Die kompakte Fallübersicht liefert bei Ereignissen noch keine vollständigen Einzelheiten, Anmerkungen und Originalnotizen. Ein eigenes Lese-Werkzeug dafür fehlt.

• Ausstehende Abnahme: Weitere Bedien-, Assistenten-, Texterkennungs- und Wiederherstellungsprüfungen bleiben offen. Technische Tests bestätigen keine rechtliche Richtigkeit; offene Quellenhinweise bleiben zu prüfen.

Herunterladen

Danach weiter mit Einrichten: Voraussetzungen, erster Start je System, KI anbinden. Zum Weitergeben den GitHub-Link teilen und den Ordner nicht selbst neu packen (warum, steht unter Einrichten).

Im Netz

Bei Glama lassen sich die Werkzeuge im Browser ausprobieren. Das läuft in einer fremden Testumgebung, zeigt nur die Antworten der Werkzeuge ohne die Oberfläche und ist nicht für echte Unterlagen gedacht.

So sieht es aus

Zum Vergrößern anklicken. Alle Bilder zeigen den erfundenen Beispielfall („Max Muster“ gegen „Muster Logistik GmbH“), keine echten Personen.

Die Oberfläche hat eine Zentrale (Übersicht, alle Fälle, Posteingang, Fristen aller Fälle, Rechtsquellen, Bestand und Sicherung, Einstellungen, Anleitung) und je Fall eine Fallakte (Übersicht, Dokumente mit Vorschau, Beteiligte, Verfahren, Chronologie, Fristen mit Rechner, Aufgaben, Entwürfe, Beweise und Anlagen, Journal). Sie ist reines HTML, CSS und JavaScript ohne Framework und braucht keinen Zugang nach außen.

Voraussetzungen

• Python 3.12 oder neuer (python3 --version). Geprüft mit 3.12.3 unter Ubuntu und 3.14.7 unter macOS und Windows; eine ältere Fassung meldet AKA Recht beim Start. Keine weiteren Pakete.

• Geprüft am 08.10.2026 nur auf macOS: Funktionstest mit 99 Prüfpunkten.

• Geprüft am 02.10.2026 auf macOS, Linux und Windows: Funktionstest mit 77 Prüfpunkten und die Oberfläche.

• Geprüft am 18.09.2026 auf macOS 26.7, auf Ubuntu 24.04 (Python 3.12) und auf Windows 11 (Python 3.14.7), damals mit 61 Prüfpunkten: Dienst über das Startskript, MCP-Server, Beispielfall in einem Ordner mit Leerzeichen und Umlauten, Texterkennung mit Foto und zweiseitigem Scan. Die Anbindung der Assistenten, die Texterkennung und die Sicherung sind auf Linux und Windows seither nicht erneut geprüft.

• Für Textauszüge aus PDF optional das Programm pdftotext (Paket poppler).

• Für Fotos und Scans ohne Textschicht optional die Texterkennung (OCR) tesseract mit deutscher Sprache; PDF-Scans brauchen dazu pdftoppm (auch Paket poppler). Ohne diese Programme bleibt alles wie bisher, die Mappe meldet nur, dass kein Text gelesen wurde.

1. Mappe starten

Doppelklick auf Start.command. Beim ersten Mal fragt macOS nach, ob du das Programm wirklich öffnen willst — das ist normal, die Datei kommt aus dem Internet. Wenn der Doppelklick nichts tut: Rechtsklick auf die Datei, Öffnen, dann im Fenster noch einmal Öffnen.

Geklappt, wenn: Ein schwarzes Fenster erscheint und der Browser die Mappe zeigt. Das Fenster kannst du danach schließen — der Dienst läuft in einer eigenen Sitzung weiter. Zum Beenden zuerst offene Änderungen speichern, dann im Terminal in diesem Ordner python3 "06 Werkzeuge/dienst/server.py" --stop ausführen. Der Befehl beendet nur den Dienst dieser Mappe und seine Anmeldungen. Beim nächsten Doppelklick entsteht ein neuer Startlink. Er gilt zwei Minuten und nur einmal; bei einem alten Link die Startdatei erneut öffnen.

2. Texterkennung einrichten — freiwillig

Nur nötig, wenn du Fotos oder eingescannte Briefe ohne Textschicht einlesen willst. Ohne diesen Schritt läuft alles andere.

Dafür brauchst du Homebrew, eine Paketverwaltung für macOS — ein Programm, das andere Programme installiert. Prüfen, ob du es schon hast:

brew --version

Kommt eine Fehlermeldung, zuerst Homebrew installieren (siehe brew.sh). Danach:

brew install poppler tesseract tesseract-lang

Geklappt, wenn: Der folgende Befehl deu in der Liste zeigt.

tesseract --list-langs

Hinweis: Auf Intel-Macs mit neuem macOS gibt es teils keine fertigen Pakete. Homebrew baut dann aus dem Quelltext, und das kann eine Stunde oder länger dauern (am 17.09.2026 auf macOS 26.7 so erlebt). Das Fenster einfach laufen lassen.

3. Wichtig: den Ordner nicht selbst neu packen

Weder mit zip oder ditto noch mit dem Finder („Komprimieren"). Keiner dieser Wege schreibt eine UTF-8-Kennung ins Archiv. Wer es dann auf einem anderen Rechner entpackt, bekommt aus 06 Entwürfe einen kaputten Namen wie 06 Entwürfe (am 18.09.2026 für Finder und zip geprüft).

Am Mac merkt man davon nichts, weil der Finder seine eigenen Archive wieder richtig öffnet. Kaputt geht es erst beim Wechsel auf Windows oder Linux.

Zum Weitergeben: den GitHub-Link teilen. Zum Sichern: den Knopf in der Mappe benutzen — der packt mit Pythons zipfile und damit sauber.

1. Mappe starten

./Start.sh

Fehlt das Ausführungsrecht, einmalig:

chmod +x Start.sh

Geklappt, wenn: Der Browser zeigt die Mappe. Als Dateimanager dient xdg-open.

2. Texterkennung einrichten — freiwillig

Nur nötig für Fotos und eingescannte Briefe ohne Textschicht. Unter Ubuntu und Debian genügt ein Befehl:

sudo apt install poppler-utils tesseract-ocr tesseract-ocr-deu

Er fragt nach deinem Passwort; beim Tippen ist nichts zu sehen, das ist so gewollt. Andere Distributionen haben eigene Paketnamen (Fedora: dnf install poppler-utils tesseract tesseract-langpack-deu).

Geklappt, wenn: deu in der Liste steht.

tesseract --list-langs

3. Geprüft

Am 02.10.2026: Funktionstest mit 77 Prüfpunkten und die Oberfläche.

Am 18.09.2026, Ubuntu 24.04 mit Python 3.12: Funktionstest mit damals 61 Prüfpunkten, Dienst über Start.sh, MCP-Server, Beispielfall in einem Ordner mit Leerzeichen und Umlauten. Die Texterkennung hat Foto und zweiseitigen Scan ohne Textschicht erkannt (tesseract 5.3.4).

1. Mappe starten — und zwar zuerst

Doppelklick auf Start.bat.

Wichtig: Das muss vor dem ersten Start von Claude Code oder Codex passieren. Grund: Unter Windows heißt der Befehl python, nicht python3 — python3.exe ist dort nur ein Verweis auf den Microsoft Store. Start.bat stellt deshalb .mcp.json, .claude/settings.json und .codex/config.toml auf python um. Wer die KI vorher startet, bekommt die Meldung „Python wurde nicht gefunden" und die Hooks laufen nicht.

Geklappt, wenn: Der Browser zeigt die Mappe. Wer mit git arbeitet, sieht die drei Dateien danach als geändert. Das ist eine bekannte Einschränkung des Starters (Auditpunkt 10, noch offen), kein Grund zum pauschalen Zurücksetzen.

2. Texterkennung einrichten — freiwillig

Nur nötig für Fotos und eingescannte Briefe ohne Textschicht, und für Text aus PDF. Windows bringt weder tesseract noch pdftotext mit. Beide gibt es über winget, die Paketverwaltung von Windows. Eingabeaufforderung öffnen (Startmenü, cmd tippen) und nacheinander:

winget install --id UB-Mannheim.TesseractOCR

winget install --id oschwartz10612.Poppler

3. Deutsche Sprache nachlegen

Der tesseract-Installer bringt nur Englisch mit. Im Installationsfenster unter „Additional language data" German mitwählen.

Läuft er ohne Fenster durch, fehlt Deutsch. Dann deu.traineddata von tessdata laden und nach C:\Program Files\Tesseract-OCR\tessdata legen — dafür braucht der Explorer Administratorrechte.

4. Prüfen

Ein neues Fenster öffnen (das alte kennt die neuen Programme noch nicht):

tesseract --list-langs

Geklappt, wenn: deu, eng und osd in der Liste stehen.

Findet Windows den Befehl nicht, liegt das am tesseract-Installer: Er trägt das Programm nicht in den Suchpfad ein. Für die Mappe ist das kein Problem — sie sucht zusätzlich an den üblichen Orten. Zum Prüfen von Hand hilft der volle Pfad:

"C:\Program Files\Tesseract-OCR\tesseract.exe" --list-langs

5. Geprüft

Am 02.10.2026: Funktionstest mit 77 Prüfpunkten und die Oberfläche.

Am 18.09.2026, Windows 11 mit Python 3.14.7: Funktionstest mit damals 61 Prüfpunkten, Texterkennung an Foto und zweiseitigem Scan, Claude Code mit MCP-Server (damals 32 Werkzeuge) und greifendem Originalschutz.

Erster Start

1. Holen: git clone https://github.com/Cehha79/aka-recht oder auf GitHub „Code“, „Download ZIP“ und entpacken; den Ordner an einen Ort deiner Wahl legen. Zum Weitergeben den GitHub-Link teilen, den Ordner nicht selbst neu packen (siehe macOS oben).

2. Starten: macOS Start.command, Linux Start.sh, Windows Start.bat. Der Dienst läuft nur auf 127.0.0.1, der Standardbrowser öffnet die Oberfläche. Beim ersten Start entsteht zentrale.json.

3. Unter „Einstellungen“ deinen Absender eintragen (Name, Anschrift, Kontakt); er landet in zentrale.json auf deinem Rechner und füllt später „Von:“ und Unterschrift in Entwürfen aus den Vorlagen.

4. In der Oberfläche „Neuer Fall“ anlegen, Post nach 01 Eingang legen oder in „Dokumente“ hinzufügen, ordnen, Fristen rechnen, Journal führen.

5. Seite „Anleitung“ in der Oberfläche lesen, dort steht auch, wie du eine KI anbindest.

KI anbinden

Sitzung im Ordner starten; .mcp.json liegt bei; Dialog bestätigen; mit /mcp prüfen. Skills unter .claude/skills/ (/fallaufnahme, /fristencheck, /entwurf …), Hooks aus .claude/settings.json.

• Weg A: einmalig codex mcp add aka-recht -- python3 "<voller Pfad>/06 Werkzeuge/dienst/mcp_server.py".

• Weg B ohne diesen Eintrag: den Projektordner in ~/.codex/config.toml als vertraut eintragen ([projects."<voller Pfad zum Projektordner>"] mit trust_level = "trusted"), dann lädt Codex die mitgelieferte .codex/config.toml; ein Eintrag für einen übergeordneten Ordner genügt nicht.

• Prüfen im Projektordner mit codex mcp list. Unter Windows python statt python3. Skills unter .agents/skills/ ($fristencheck …).

Einstellungen, Entwickler, Konfiguration bearbeiten: Eintrag aka-recht mit command python3 (unter Windows python) und args ["<voller Pfad>/06 Werkzeuge/dienst/mcp_server.py"]; Claude Desktop neu starten.

• Mit MCP: gleicher Aufruf in der Konfigurationsdatei des Assistenten; Arbeitsprofil in AGENTS.md.

• Ohne MCP, mit Befehlen: python3 "06 Werkzeuge/dienst/cli.py" liste.

• ChatGPT im Browser oder in der App startet keinen lokalen Server; es verlangt eine öffentliche HTTPS-Adresse oder einen Tunnel über OpenAI. Das ist für AKA Recht nicht vorgesehen.

Schreibende Werkzeuge laufen nur mit Bestätigung. Diese Bestätigung setzt am Ende die KI selbst; die eigentliche Sperre ist die Freigabe in deinem Assistenten. Schreibende Werkzeuge von AKA Recht dort deshalb nicht dauerhaft freigeben („immer erlauben“), sondern jeden Aufruf ansehen. Werkzeuge für Versand, Löschen oder Ändern von Originalen gibt es nicht.

Was in welchem Assistenten wirklich läuft

Drei Dinge sind zu unterscheiden: vorbereitet heißt, die Mappe bringt die Konfiguration mit; hier geprüft heißt, wir haben es am eigenen Rechner durchgespielt; offen heißt, wir wissen es nicht.

Die direkten Client-Prüfungen unten stammen vom 16. bis 18.09.2026. Der aktuelle Funktionstest prüft die MCP-Schnittstelle automatisch, ersetzt aber keinen erneuten Bedienlauf in den inzwischen installierten Assistenten.

Wichtig für reine MCP-Clients (Claude Desktop und ähnliche): Sie bekommen die Werkzeuge, aber weder das Arbeitsprofil noch die Prüfabläufe. Die Regeln dieser Mappe gelten dort nur, soweit die Werkzeuge selbst sie durchsetzen — und das tun sie: Originalbereiche bleiben gesperrt, Fristen ohne Nachweis lassen sich nicht bestätigen, Entwürfe ohne eingefrorene Fassung nicht als geprüft speichern.

Gemini CLI: Die Mappe bringt AGENTS.md mit, Gemini sucht aber standardmäßig GEMINI.md. Damit es das Profil lädt, braucht es in .gemini/settings.json einen Eintrag contextFileName mit AGENTS.md (Gemini-CLI-Dokumentation „Provide context with GEMINI.md files“, abgerufen 18.09.2026). Diesen Weg haben wir nicht geprüft; wir liefern deshalb keine fertige Gemini-Konfiguration mit. Prüfe im Client selbst nach, welche Regeln geladen wurden, bevor du eine Akte bearbeiten lässt.

Aktualisieren

Deine eigenen Daten liegen in 01 Eingang, 02 Fälle, 03 Verträge und Vorsorge und zentrale.json. Vor jeder Aktualisierung eine Sicherung anlegen („Geprüfte Sicherung erstellen“ in der Oberfläche).

Offene Änderungen in der Oberfläche speichern. Im Ordner der Mappe zuerst git status prüfen: Der Befehl zeigt lokale Änderungen. Sind keine vorhanden, mit git pull --ff-only aktualisieren; dabei wird kein abweichender Verlauf automatisch zusammengeführt. Anschließend den bisherigen Dienst mit python3 "06 Werkzeuge/dienst/server.py" --stop beenden (unter Windows python statt python3) und über die Startdatei neu öffnen. Erst dann läuft der neue Programmstand. Die vier Orte mit deinen Daten stehen in der mitgelieferten .gitignore und werden durch git nicht verwaltet; die vorherige Sicherung bleibt erforderlich.

Unter Windows verändert Start.bat .mcp.json, .claude/settings.json und .codex/config.toml. Das kann git pull blockieren (offener Auditpunkt 10). Mit git diff prüfen, was geändert wurde, und eigene Anpassungen vor dem Aktualisieren erhalten. Kein pauschales Zurücksetzen dieser Dateien: Darin können neben der Python-Umstellung auch eigene Einstellungen stehen.

1. Neue Version in einen neuen Ordner entpacken.

2. Offene Änderungen speichern, dann den bisherigen Dienst beenden. Im neuen Ordner im Terminal python3 "06 Werkzeuge/dienst/server.py" --root "<alter Ordner>" --stop ausführen (<alter Ordner> durch den vollständigen Pfad ersetzen; unter Windows python statt python3). Das neue Skript kann auch einen älteren Dienst gezielt beenden; andere Mappen bleiben geöffnet.

3. Aus dem alten Ordner 01 Eingang, 02 Fälle, 03 Verträge und Vorsorge und zentrale.json in den neuen Ordner verschieben; die leeren Ordner des neuen Ordners vorher entfernen.

4. Im neuen Ordner starten. Fälle und Einstellungen sind wieder da; die Pfade in zentrale.json sind relativ zum Ordner.

5. Hast du Codex oder Claude Desktop mit dem vollen Pfad zu mcp_server.py eingerichtet, den Pfad auf den neuen Ordner ändern.

6. Was du außerhalb dieser vier Orte selbst in der Mappe abgelegt oder geändert hast (eigene Dateien, eine angepasste CLAUDE.md), kommt nicht von selbst mit: von Hand in den neuen Ordner übernehmen. Den alten Ordner erst entfernen, wenn im neuen alles da ist.

Häufige Fragen

Für die Mappe nicht: Der Dienst läuft nur auf 127.0.0.1 und ruft keine fremden Adressen auf. Deine KI (Claude, Codex oder eine andere) braucht ihr eigenes Konto und ihren eigenen Zugang; was sie liest, verarbeitet ihr Anbieter.

Geprüft sind Claude Code, Claude Desktop und Codex (siehe „KI anbinden“). Jede andere KI, die MCP spricht oder Befehle ausführen darf, sollte gehen, ist aber nicht geprüft. ChatGPT im Browser oder in der App ist nicht vorgesehen, weil es keinen lokalen Server startet.

Nein. Die Mappe lädt nichts hoch. Wer selbst mit git arbeitet: 01 Eingang, 02 Fälle, 03 Verträge und Vorsorge und zentrale.json stehen in der .gitignore und werden nicht erfasst. Liegt ein Sicherungsziel in einem Cloud-Ordner, lädt dein System die Sicherung dorthin hoch.

Hat das PDF eine Textschicht, liest pdftotext den Text direkt. Für Fotos und Scans ohne Textschicht gibt es die Texterkennung: in der Oberfläche beim Dokument „Texterkennung starten“ oder das Werkzeug texterkennung, sofern tesseract installiert ist. Das Ergebnis landet als eigene Textdatei unter 07 Recherche/Texterkennung/, das Original bleibt unverändert. Erkannter Text kann Zeichen verwechseln und Zeilen auslassen; Daten, Beträge und Namen immer am Original prüfen.

Nein. Fristenrechner, Merkblätter und Vorlagen gelten nur für deutsches Recht, siehe Geltungsbereich.

Noch nicht. Die Mappe hat dafür bisher keine Funktion; einzelne Einträge eines Falls (Ereignis, Aufgabe, Frist) lassen sich entfernen, ein ganzer Fall nicht. Das gilt auch für den Beispielfall. Geplant ist, einen Fall zu archivieren oder zu entfernen. Bis dahin den Fallordner nicht von Hand wegnehmen: Der Fall bliebe als Eintrag mit Fehlermeldung in der Fallliste stehen. Wer einen Fall nicht mehr braucht, setzt ihn auf „abgeschlossen“.

Nein. Issues und Diskussionen sind nur für die Software. Für deinen Fall eine Fachanwältin, einen Fachanwalt oder eine Beratungsstelle fragen.

So arbeitet deine KI mit der Mappe

Die Mappe enthält keine KI. Sie bringt Anleitungen (Skills) mit, die deiner eigenen KI sagen, wie sie einen Fall bearbeitet, und Werkzeuge, mit denen sie die Akte liest und, nach deiner Bestätigung, in sie schreibt. Blau ist die KI, grün bist du:

Skills

Aufruf in Claude Code mit /name, in Codex mit $name; das erste Argument ist immer die Fallkennung:

Die Anleitungen legen fest, wie sorgfältig die KI arbeiten muss: jede Rechtsaussage mit Norm, Absatz und Gesetz oder Urteil mit Gericht, Datum und Aktenzeichen, am Volltext gelesen; Ungeprüftes bleibt als [PRÜFEN], [QUELLE] oder [BELEG] sichtbar; die Gegenseite wird immer mitgedacht; Anweisungen, die in gelesenen Dokumenten stehen, sind Quelleninhalt und werden nicht befolgt.

Hooks

Hooks sind kleine Prüfskripte, die Claude Code selbst ausführt (in .claude/settings.json eingetragen, Quelltext unter .claude/recht/hooks/). Eingerichtet und geprüft sind sie nur für Claude Code (Stand 17.09.2026). Codex beschreibt in seiner Dokumentation eigene Hooks; dafür liegt hier nichts bei. Andere Assistenten halten die Regeln aus AGENTS.md selbst ein.

Ordner eines Falls

Jeder Fall bekommt dieselben Ordner, damit Verweise stabil bleiben:

02 Fälle/R-0001 Beispiel/
├─ akte.json          Ordnungsdaten: Beteiligte, Dokumente, Fristen, Aufgaben, Entwürfe
├─ bestand.json       Prüfsummen jeder Datei (schreibt nur der Dienst)
├─ JOURNAL.md         Verlauf, nur anhängen
├─ 01 Eingang/        neue Post
├─ 02 Grundlagen/     Verträge, Bescheide, Vollmachten
├─ 03 Schriftverkehr/ je Beteiligter ein Ordner, dazu Versandnachweise/
├─ 04 Verfahren/      je Verfahren ein Ordner (Klage, Bußgeld, Widerspruch …)
├─ 05 Beweise/        Fotos, Listen, Quittungen
├─ 06 Entwürfe/       noch nicht versandte Texte, Name endet auf _ENTWURF
├─ 07 Recherche/      Prüfvermerke, fallbezogene Rechtsquellen
└─ 08 Archiv/         alte Übersichten, unverändert

Originale in 02 bis 05 und 08 werden nie verändert, umbenannt oder gelöscht; in Claude Code sperrt ein Hook die Schreibwerkzeuge der KI dort, Shell-Befehle deckt er nicht ab. Neue Texte entstehen in 06, Vermerke in 07.

Werkzeuge

Dieselben 36 Werkzeuge erreicht die KI über MCP (06 Werkzeuge/dienst/mcp_server.py) oder über die Befehlszeile (python3 "06 Werkzeuge/dienst/cli.py" <werkzeug> feld=wert). Schreibende Werkzeuge laufen über MCP nur mit deiner Bestätigung (es zählt allein der JSON-Wert true); über die Befehlszeile soll die KI vorher fragen. Lesende Werkzeuge ändern keine Datei: Eine neue oder im Dateimanager verschobene Datei melden sie nur, ihre Kennung bekommt sie erst durch bestand_abgleichen; die Oberfläche macht das beim Öffnen eines Falls selbst. Jede Änderung an akte.json wird gegen das Datenmodell geprüft und mit Revision gespeichert.

Vorlagen

Vorlagen unter 05 Vorlagen/Schreiben/: oben interne Hinweise (Frist, Form, Adressat), unter der Trennlinie der Sendetext mit Platzhaltern 【 】. Der Word-Erzeuger .claude/recht/werkzeuge/docx_erzeugen.py macht daraus eine .docx und warnt vor offenen Platzhaltern und Markern.

Merkblätter

Merkblätter unter 04 Rechtsquellen/Verfahren/ beschreiben je Rechtsbehelf Frist, Form, Pflichtinhalt, Adressat und Wirkung, jede Angabe mit Norm und Prüfdatum. /fallaufnahme nennt daraus den Rechtsbehelf, /entwurf prüft den Pflichtinhalt dagegen.

Befehle

Worauf du dich verlassen kannst

Eine Rechtsakte braucht mehr als Ordner. Diese Regeln setzt die Mappe technisch durch und prüft sie im Funktionstest:

• Originale bleiben Originale. Schreiben in 02 Grundlagen, 03 Schriftverkehr, 04 Verfahren, 05 Beweise und 08 Archiv weist ein Hook ab, bevor die KI die Datei anfasst — geprüft am aufgelösten Pfad, also auch über Umwege wie .. oder Verknüpfungen, und unabhängig davon, wie Umlaute im Pfad geschrieben sind. Der Hook gilt für Claude Code und dort für dessen Dateiwerkzeuge (Write, Edit, MultiEdit, NotebookEdit). Neue Fassungen gehören nach 06 Entwürfe, Vermerke nach 07 Recherche. Grenzen: Beliebige Befehle einer Shell deckt er nicht ab — wer der KI erlaubt, Befehle auszuführen, umgeht ihn. Für Codex und andere Assistenten ist kein solcher Hook eingerichtet; dort schützen die Werkzeuge der Mappe selbst, die in die Originalbereiche nicht schreiben.

• Lesen bleibt Lesen. Kein lesendes Werkzeug fasst akte.json, bestand.json oder zentrale.json an. Neue Dateien registriert nur der Abgleich.

• Kennungen kommen nie wieder. Ein Zähler je Kennungsart merkt sich die höchste je vergebene Nummer; ein entfernter Eintrag wird nie durch einen neuen mit derselben Kennung ersetzt, Journalverweise bleiben eindeutig.

• Geprüfte und versandte Fassungen sind eingefroren. Beim Status „geprüft“ oder „versandt“ legt die Mappe eine nur lesbare Kopie unter 06 Entwürfe/Fassungen/ ab, mit Prüfsumme und eigener Kennung. Die Arbeitsdatei darf sich ändern, die Kopie nie.

• Fristen werden nachgerechnet. §§ 187, 188, 193 BGB mit sichtbarer Rechnung; Monatsende, Schaltjahr und Jahresfristen sind mit 20 Grenzfällen geprüft. Ob eine Frist gilt, entscheidet der Rechner nicht.

• Bestätigt heißt geprüft. Eine Frist wird nur „bestätigt“, wenn die Rechnung das Fristende nennt, Beleg und Auslöser da sind und kein Marker [PRÜFEN], [QUELLE] oder [BELEG] offen ist; die Bestätigung trägt Prüfdatum und Prüfer, ein Termin braucht die Ladung als Quelle.

• Fremde Anlagen starten nichts. „Öffnen“ ruft das Systemprogramm nur für bekannte Dokumentformate (PDF, Text, Office, Bilder, E-Mail, Ton, Video); Skripte, Programme, Webseiten, Archive und Unbekanntes werden nur im Dateimanager gezeigt, mit Hinweis.

• Unsicheres bleibt sichtbar. Ein Ereignis kann „ungefähr“, „Zeitraum“ oder „unbekannt“ sein, statt einen erfundenen Tag zu tragen; eine Frist nennt ihr Verfahren und ihr Auslöser-Ereignis, und auf einem unsicheren Ereignis wird sie nicht bestätigt.

• Übergaben enthalten nur, was hin soll. Das Paket wird für einen benannten Empfänger gebaut, zeigt vorher jede Datei, bricht bei unbekannten Kennungen ab und wird gegen sein Manifest zurückgelesen.

• Sicherungen sind nachweislich brauchbar. Jede ZIP wird nach dem Schreiben zurückgelesen; „Wiederherstellung prüfen“ entpackt sie in einen Zwischenordner und prüft Akten und Prüfsummen.

• Daten bleiben da, wo du sie legst. Keine KI in der Mappe, kein Netz im Dienst. Was in einen Cloud-Ordner gesichert wird, lädt dein System hoch; was deine KI liest, verarbeitet ihr Anbieter.

Sicherung

„Geprüfte Sicherung erstellen“ in der Oberfläche schreibt eine ZIP außerhalb des Ordners und liest sie zurück. Ziel und zweites Ziel stehen in den Einstellungen und werden vor der ersten Sicherung angezeigt. „Wiederherstellung prüfen“ entpackt die letzte Sicherung in einen Zwischenordner, prüft Akten und Prüfsummen und räumt ihn wieder ab. Echte Wiederherstellung immer in einen neuen Ordner, nie über die laufende Mappe: python3 "06 Werkzeuge/dienst/server.py" --restore <ZIP> <neuer Ordner>. Ohne Oberfläche: --check prüft den Bestand, --backup sichert, --probe prüft die letzte Sicherung.

Drei Ebenen, die nicht dasselbe sind: Die Mappe liegt auf deinem Rechner. Liegt ein Sicherungsziel in iCloud Drive oder einem anderen Cloud-Ordner, lädt das Betriebssystem die unverschlüsselte ZIP dorthin hoch. Ein zweites Ziel ist ab Werk leer; ob eines in die Cloud geht, entscheidest du in den Einstellungen. Und was deine KI liest, verarbeitet deren Anbieter nach seinen Bedingungen; ein lokaler MCP-Server ändert daran nichts.

Geltungsbereich

Diese Fassung ist für deutsches Recht gebaut: Fristenrechner nach §§ 187, 188, 193 BGB mit den landesweiten Feiertagen aller 16 Bundesländer (Bundesland in den Einstellungen wählen; regionale Feiertage einzelner Gemeinden zählen nicht, einmalige Feiertage wie in Berlin 2025 und 2028 sind eingetragen), Quellenkatalog mit deutschen amtlichen Angeboten, Schreibvorlagen und Merkblätter für deutsche Verfahren.

Andere Rechtsordnungen sind nicht vorgesehen. Außerhalb Deutschlands lässt sich die Mappe zum Ordnen von Unterlagen nutzen, Fristen und Vorlagen gelten aber nur für Deutschland.

Die Oberfläche und ihre Anleitung gibt es auf Deutsch und Englisch (Einstellungen › Sprache). Vorlagen, Merkblätter, Skills und dieses README sind nur auf Deutsch; die Werte in den Akten bleiben ebenfalls deutsch.

Grenzen

Mitmachen und Unterstützen

Die Mappe ist kostenlos und wird offen entwickelt. Fehler, Vorschläge, Übersetzungen, Vorlagen, Merkblätter und später ganze Länderpakete sind willkommen. Bitte keine echten Akten, Namen oder Aktenzeichen einreichen. Beiträge stehen unter derselben Lizenz (AGPL-3.0). Wie ein Beitrag abläuft, steht in CONTRIBUTING.md.

Issues und Diskussionen sind nur für die Software und erfundene Beispiele da. Fragen zu einem echten Fall („Gilt bei mir die Frist?“) werden dort nicht beantwortet: Fallberatung ist nicht Gegenstand dieses Projekts, und niemand hier kennt deine Angelegenheit. Wende dich dafür an eine Fachanwältin, einen Fachanwalt oder eine Beratungsstelle.

Wenn dir die Mappe geholfen hat und du etwas zurückgeben willst, freut sich der Autor über freiwillige Unterstützung unter https://github.com/sponsors/Cehha79. Kontakt: info@mika-tec.com.

Lizenz

Copyright 2026 Hasan Tepegöz. Freie Software unter der GNU Affero General Public License, Version 3 (AGPL-3.0), Wortlaut in LICENSE. In Klartext:

• Du darfst die Mappe kostenlos nutzen, kopieren, ändern und weitergeben, privat wie beruflich.

• Wer sie verändert weitergibt oder als Dienst über ein Netz anbietet, muss den vollständigen Quelltext unter derselben Lizenz mitliefern.

• Lizenztext und Urheberhinweise bleiben bei jeder Weitergabe dabei.

• Keine Gewährleistung, keine Haftung, soweit das Gesetz das zulässt.

Maßgeblich ist allein der englische Text in LICENSE; dieser Abschnitt erklärt ihn nur.

Impressum

Angaben gemäß § 5 DDG und § 18 MStV

Hasan Tepegöz, Einzelunternehmen MikaTec Pontoiser Straße 54 71034 Böblingen Deutschland

Telefon: 0173 5904496 E-Mail: info@mika-tec.com Web: https://www.mika-tec.com

Kleinunternehmer gemäß § 19 UStG; es wird keine Umsatzsteuer ausgewiesen. Verantwortlich im Sinne des § 18 Abs. 2 MStV: Hasan Tepegöz, Anschrift wie oben.

Hinweis zu Künstlicher Intelligenz

AKA Recht enthält selbst keine KI. Dienst, Oberfläche, Fristenrechner und Werkzeuge führen ausschließlich fest programmierte Regeln aus; es wird nichts gelernt und nichts abgeleitet. Die Mappe ist damit kein KI-System im Sinne von Art. 3 Nr. 1 der Verordnung (EU) 2024/1689 (KI-Verordnung).

Wer die Mappe mit einem eigenen KI-Assistenten nutzt, arbeitet mit einem fremden KI-System. Dessen Ausgaben sind Entwürfe, keine geprüften Rechtsaussagen: Sie können falsch, veraltet oder erfunden sein. Sie tragen deshalb die Marker [PRÜFEN], [QUELLE] und [BELEG] und sind vor jeder Verwendung am Originalvolltext zu prüfen. Fristen, Schreiben und Erklärungen verantwortet allein die Nutzerin oder der Nutzer.

AKA Recht leistet keine Rechtsberatung und keine Rechtsdienstleistung im Sinne des § 2 RDG. Bei Weichenstellungen: Fachanwältin, Fachanwalt oder eine anerkannte Beratungsstelle.