Codexplain: Das Projekt, um Codex wie Claude Code sprechen zu lassen
(github.com/NomaDamas)Wenn man Codex benutzt, merkt man: Code wird zwar gut überarbeitet, aber bei den Erklärungen denkt man sich manchmal: „Was soll das eigentlich heißen?“
Besonders störend fand ich drei Punkte.
- Erklärungen mit Fokus auf Datei- und Funktionsnamen
- Codex erklärt oft nach Dateien wie README.md, rust/codexplain.rs oder package.json, statt zu beschreiben, „welche Funktion wie durch den Ablauf läuft“. Wenn man die Projektstruktur schon kennt, ist das okay, aber in einer Codebasis, die man zum ersten Mal sieht, muss man oft noch einmal nachfragen.
- Schwer lesbare Fließtexte im Terminal
- Wenn die Erklärung wie bei Claude Code mit TLDR, Tabellen, Diagrammen, Risk Panel und Next Action strukturiert ist, lässt sie sich deutlich schneller erfassen. Bei Codex sind die Erklärungen dagegen oft eher Fließtext.
- Die Schlussfolgerung kommt spät und es gibt viel TMI
- Nutzer wollen zuerst wissen: „Was muss ich jetzt eigentlich verstehen?“ Codex liefert dagegen oft den gesamten Kontext auf einmal.
Deshalb habe ich Codexplain gebaut.
Codexplain ist kein Modell, das Codex ersetzt, sondern eine Explanation-UX-Layer, die Codex-Antworten lokal im Projekt besser lesbar macht.
Hauptfunktionen:
- Aufbereitung von Erklärungen im Format TLDR / Zusammenfassung / Tabelle / Architekturdiagramm / Risk Panel / Next Action
- Strikte Artefakte wie JSON, code, diff, patch, log und test output bleiben unverändert erhalten
- Steuerung von explanation depth, architecture depth und abstraction level
- terminalfreundliches semantisches Highlighting
- projektlokale Einstellungen auf Basis von
codexplain/ - Eigene custom explanation styles für Teams oder Einzelpersonen
- Lokales Ein-/Ausschalten sowie Deinstallation möglich
Installation:
npm install -g codexplain
codexplain install-codex --local --force
Wenn Sie beim Einsatz von Codex das Gefühl hatten: „Der Code stimmt, aber die Erklärung ist zu unfreundlich“, probieren Sie es gern einmal aus und erstellen Sie ein Issue zu fehlenden Punkten oder gewünschten Erklärungsstilen! Stars sind natürlich immer willkommen ⭐️
Noch keine Kommentare.