LazyCodex: der OmO-Agent-Harness fuer Codex mit Projektmemoerie und verifizierter Fertigstellung
Der einzige Agenten-Harness für komplexe Codebasen. Projektspeicher, Planung, Ausführung und überprüfter Abschluss innerhalb von Codex.
Auf einen Blick
- Was ist das?
- Wie das TypeScript-Repository code-yeongyu/lazycodex die OmO-Qualitaetsleiste in Codex bringt, was die Befehle ulw-loop, ulw-plan und start-work leisten und wie Installation ueber npx oder den Codex-Marktplatz ablaeuft.
- Für wen ist es gedacht?
- LazyCodex richtet sich an Entwickler, die Codex in grossen Codebasen einsetzen und eine Arbeitsstruktur aus Projektgedaechtnis, Planung, Ausfuehrung und belegbasierter Fertigstellung wollen, ohne OmO von Hand zu konfigurieren. Vor dem Ernstfall lohnt ein Blick auf zwei Mechanismen: die Hooks, die laut README erst nach Freigabe im Codex-Startup-Review laufen, und der Doctor-Befehl npx lazycodex-ai doctor, der Zustand von Plugin-Cache, Hooks, MCP-Servern und Agenten meldet.
- Darf ich es kommerziell nutzen?
- Ja. MIT ist eine freizügige Lizenz: Sie dürfen darauf aufbauende Software nutzen, verändern und verkaufen, solange Sie die Urheberrechts- und Lizenzhinweise beibehalten.
- Wird es noch gepflegt?
- Ja. Die letzten Commits kamen vor 3 Tagen.
- In welcher Sprache ist es geschrieben?
- Hauptsächlich TypeScript, laut der Sprachstatistik von GitHub.
Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 14. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.
TIEFGEHENDE OPEN-SOURCE-ANALYSE
Die OmO-Qualitaetsleiste fuer Codex als Installationspaket
LazyCodex bezeichnet sich im README als den Agent-Harness fuer komplexe Codebasen, der Projektmemoerie, Planung, Ausfuehrung und verifizierte Fertigstellung innerhalb von Codex vereint. Technisch ist es die Codex-Distribution des Agent-Harnesses von OmO, dem Projekt oh-my-openagent von Sisyphus Labs. Der Einstiegsnotiz zufolge ist die OmO-Qualitaetsstufe nun auch fuer Codex verfuegbar, ohne dass man die komplette Einrichtungskermik von Hand durchlaeuft. Das Projekt steht unter MIT-Lizenz, ist in TypeScript geschrieben und zaehlt rund 3.300 Sterne mit 19 offenen Issues.
Die.Release-Aktivitaet ist hoch: v4.19.4 erschien am 1. August 2026, davor v4.19.3 am 28. Juli und v4.19.2 am 26. Juli. Diese kurzen Zyklen zeigen ein Projekt in Bewegung, was fuer Nutzer heisst, dass Upgrade-Hinweise und der Doctor-Befehl Teil des Betriebsalltags sein sollten. Die Vollversion der Dokumentation liegt ausserhalb des Repositories auf lazycodex.ai/docs.
Installation ueber npx oder den Codex-Marktplatz
Der Hauptinstallationsweg ist eine Zeile: npx lazycodex-ai install, laut README ausdruecklich ohne globale Installation und ohne npm i -g, stets ueber npx. Der Befehl ist die Kurzform von npx --yes --package oh-my-openagent omo install --platform=codex. Wer eine vollautonome Variante ohne TUI will, ergaenzt --no-tui --codex-autonomous; laut README bleibt diese autonome Betriebsart eine ausdrueckliche Entscheidung, der Marktplatzpfad ruehrt die Berechtigungseinstellungen von Codex nie an.
Experimentell existiert ein zweiter Weg von innen: In Codex tippt man /plugins, oeffnet den Add-Marketplace-Reiter, traegt https://github.com/code-yeongyu/lazycodex ein und installiert omo aus dem Sisyphuslabs-Marketplace. Auf der Kommandozeile lauten die Befehle codex plugin marketplace add https://github.com/code-yeongyu/lazycodex und codex plugin add omo@sisyphuslabs. Beim naechsten Start erscheinen die omo-Hooks im Startup-Review von Codex zur Freigabe, und laut README laufen Hooks nie vor einer solchen Freigabe. Die erste freigegebene Sitzung meldet LazyCodex bootstrap running in background und verlangt einen Neustart, waehrend ein Hintergrundworker Konfigurationsbloecke, Agentenrollen, bin-Links und ein angeheftetes sg-Binary fuer das ast_grep-MCP fertigstellt.
Die drei Befehlssaeulen: ulw-plan, start-work, ulw-loop
LazyCodex installiert die OmO-Befehle, die in Codex mit $-Praefix aufgerufen werden. $ulw-plan ist laut README der strategische Prometheus-Planer: Er schreibt einen Plan nach plans/<slug>.md und beruehrt nie den Produktcode, passt also, wenn Entscheidungen vor der Implementierung anstehen. $start-work fuehrt einen fertigen Plan aus, arbeitet die Checkliste mit dauerhaftem Boulder-Fortschritt ab und stoppt erst, wenn jeder Punkt erledigt ist, woraufhin es ORCHESTRATION COMPLETE druckt.
$ulw-loop ist die selbstreferenzielle Schleife fuer offene Aufgaben: Sie laeuft, bis die Fertigstellung vom Oracle verifiziert ist, mit einem Limit von 500 Iterationen im Ultrawork-Modus und 100 im normalen Modus. Optional nehmen die Befehle --completion-promise=TEXT und --strategy=reset beziehungsweise --strategy=continue an. Die README formuliert die Unterscheidung praegnant: ulw-loop gehoert dorthin, wo das Ergebnis durch Belege statt durch eine hoffnungsvolle Statusmeldung bestanden sein soll.
Projektgedaechtnis mit init-deep und die Skill-Ebene
$init-deep erzeugt hierarchisches AGENTS.md-Kontextgedaechtnis: Es bewertet komplexe Verzeichnisse, schreibt lokale Hinweise in die Naehe des Codes, der sie braucht, und gibt kuenftigen Agenten Landmarken, bevor sie editieren. Laut README ist der richtige Moment dafuer ein Repository, das zu gross ist, um es aus dem Gedaechtnis zu erklaeren, und ein erneuter Lauf, wenn sich die Form der Codebasis aendert. In Codex zeigt das $-Zeichen im Composer alle installierten Skills an, und Hooks melden sich mit LazyCodex als Versionsstatuszeilen waehrend einer Sitzung.
Ueber die drei Hauptsaeulen hinaus installiert das Paket Spezialisten-Skills: review-work fuer mehrperspektivische Nachbereitung, remove-ai-slops fuer verhaltenserhaltende Bereinigung von KI-typischem Code, frontend-ui-ux fuer UI-Oberflaechen, programming fuer strenge Disziplin in TypeScript, Rust, Python oder Go, LSP fuer Diagnosen, Definitionen und Umbenennungen, AST-grep fuer strukturelle Suche und Umbau ueber den Code, rules fuer Projekthinweise aus AGENTS- und Regeldateien sowie comment-checker fuer Rueckmeldungen nach editaehnlichen Operationen.
Sub-Agentenrollen ueber spawn_agent
LazyCodex legt auswaehlbare Agentenrollen nach ~/.codex/agents/: explorer, librarian, plan, momus, metis und codex-ultrawork-reviewer. Angesprochen werden sie, indem man dem nativen spawn_agent-Werkzeug von Codex den Parameter agent_type mitgibt; das Kindobjekt laeuft dann mit dem Modell und den Anweisungen dieser Rolle. Das README zeigt den Aufruf als JSON-Beispiel: spawn_agent mit der Nachricht TASK: map the auth flow end to end und agent_type explorer.
Der Installer exposet agent_type auf multi_agent_v2-Sitzungen, die Codex standardmaessig verbirgt. Falls die eigene Codex-Build das Parameter nicht kennt, fuehrt laut README der Weg ueber die Rollenbeschreibung innerhalb der Nachricht, weil die Skills automatisch auf diese Form zurueckfallen. Diese Rückfaellebene macht die Rollen bertragbar zwischen Codex-Staenden, was bei einem Projekt mit schnellen Releases praktisch relevant ist.
Doctor, Upgrade und Rueckbau
Fuer den Betrieb liefert LazyCodex drei Verwaltungswerkzeuge. npx lazycodex-ai doctor druckt laut README den Installationsgesundheitsbericht: Plugin-Cache, Hooks, MCP-Server, Agenten und Konfigurationszustand, und erklaert, was und warum hakt, falls etwas unvollstaendig wirkt. Upgrades laufen im Marktplatzpfad mit codex plugin marketplace upgrade sisyphuslabs; danach zeigt das Startup-Review die Hooks als Modified an, was nach jedem Upgrade zu erwarten ist, und nach erneuter Freigabe laeuft das Bootstrap in der naechsten Sitzung auf der neuen Version.
Der Rueckbau ist symmetrisch dokumentiert: npx lazycodex-ai uninstall entfernt den installierten Plugin-Cache, die bin-Links, die Agentenrollen und die verwalteten Abschnitte von ~/.codex/config.toml. Diese Klarheit ueber das, was das Paket auf dem System hinterlaesst, ist fuer ein Werkzeug, das Hooks in einen Editor-Agenten injiziert, mehr als eine Nebensache: Wer es ausprobiert, kann den Ausprobier-Zustand vollstaendig zurueckrollen, und der Doctor zeigt nach einem Upgrade sofort, ob die Bootstrap-Phase die neue Version uebernommen hat.
Redaktionelles Fazit
LazyCodex richtet sich an Entwickler, die Codex in grossen Codebasen einsetzen und eine Arbeitsstruktur aus Projektgedaechtnis, Planung, Ausfuehrung und belegbasierter Fertigstellung wollen, ohne OmO von Hand zu konfigurieren. Vor dem Ernstfall lohnt ein Blick auf zwei Mechanismen: die Hooks, die laut README erst nach Freigabe im Codex-Startup-Review laufen, und der Doctor-Befehl npx lazycodex-ai doctor, der Zustand von Plugin-Cache, Hooks, MCP-Servern und Agenten meldet. Wer die autonome Variante will, waehlt sie ausdruecklich mit --no-tui --codex-autonomous, der Marktplatzpfad aendert die Berechtigungseinstellungen von Codex nicht.
Community-Notizen