aka-recht

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 Schlüssel, kein Netz. Der Dienst läuft nur auf deinem Rechner.

Produkt Version 0.4 vom 18.09.2026, neuester Stand vom 04.10.2026 · Datenformat akte.json Schema 1 · MCP-Protokoll 2026-07-28 und 2025-11-25 · geprüft mit Python 3.14.7 auf macOS 26.7.1, Ubuntu 24.04 (Python 3.12) und Windows 11 (Python 3.14) · Autor: Hasan Tepegöz

Neu seit Version 0.4

Diese Punkte stehen im neuesten Stand vom 04.10.2026, noch nicht in der festen Version 0.4. Wer die feste Version von der Release-Seite lädt, bekommt sie mit der nächsten Version. Geprüft mit dem Funktionstest (77 Prüfpunkte) und in der Oberfläche auf macOS, Linux und Windows.

• 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. 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.
• 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.

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.

Zentrale: alle Fälle, nächste Fristen, Posteingang	Fallakte: Rolle, Ziel, Verfahren, Fristen, Aufgaben
Dokumente: Vorschau, Kennung, Anlagennummer, Einsortieren	Fristen: Rechtsgrundlage, Rechenweg, Prüfstatus
Chronologie: Zeitpfad mit Kernereignissen, Abständen und Fundstellen

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.

_{↑ nach oben zu den Reitern}

Voraussetzungen

• Python 3.12 oder neuer (python3 --version). Geprüft mit 3.12.3 unter Ubuntu und 3.14.7 unter macOS und Windows; ältere Fassungen sind ungeprüft. Keine weiteren Pakete.
• 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.

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

Schreibende Werkzeuge laufen nur, wenn du den Aufruf bestätigst. 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.

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).

Häufige Fragen

_{↑ nach oben zu den Reitern}

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.

_{↑ nach oben zu den Reitern}

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; ein Hook sperrt das für die KI. 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

_{↑ nach oben zu den Reitern}

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. 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

_{↑ nach oben zu den Reitern}

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.

_{↑ nach oben zu den Reitern}

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.