Maggy, der Open-Source-KI-Engineering-Harness von palgu>.
Vom Team hinter palgu>: Maggy ist unser Open-Source-Harness, der Claude Code, Codex, Kimi und Gemini CLI in einen testgestützten Workflow mit Qualitäts-Gates verwandelt, inklusive kostenbewusstem Routing über 13 Modellstufen, sitzungsübergreifendem Gedächtnis und einem Plugin-System. Führen Sie ihn lokal aus, behalten Sie die Kontrolle über jede Zeile. Verbinden Sie ihn mit palgu>, wenn Ihr Team ein zentral gesteuertes Gateway benötigt.
- Ihr eigenes Multi-Modell-Routing lokal betreiben: eigene Keys, das günstigste geeignete Modell pro Aufgabe.
- Ergänzen Sie Ihre CLI um einen echten Engineering-Harness: TDD, Gates, Gedächtnis und Agententeams.
- Selbst hosten und volle Kontrolle behalten: durchgehend Open Source, kein Konto und kein Gateway erforderlich.
Zwei Teile, ein Repository
Starten Sie in 30 Sekunden mit Bootstrap; fügen Sie den Maggy-Server hinzu, sobald Sie Routing, Protokolle und das Dashboard wünschen.
Ein installierbares Konfigurationspaket (67 Skills, Hooks, Regeln, Vorlagen), das in ~/.claude/ abgelegt wird und ab Ihrer nächsten Session greift. In rund 30 Sekunden installiert; funktioniert mit Claude Code, Codex, Kimi und Gemini CLI.
Ein optionaler lokaler FastAPI-Server samt Web-Dashboard für 13-stufiges Routing, Skill-Protokolle, den Cortex-Code-Graphen über MCP, Polyphony-Isolation und Plugins. maggy serve → localhost:8080
Kernsysteme
Alles, was Maggy ergänzt, an einem Ort.
Jede Aufgabe geht an das günstigste Modell, das sie tatsächlich lösen kann.
- Jede Nachricht wird auf einer Skala von 1 bis 10 nach Komplexität und Risiko bewertet (der „Blast Score“) und nach Aufgabentyp klassifiziert, alles lokal durch einen kostenlosen Qwen3-Klassifikator, sodass die Triage nichts kostet.
- Der Score wählt eine Stufe: T0 Qwen3 (lokal) für Klassifizierung und Massenoperationen, aufsteigend über DeepSeek, Kimi, Gemini, Grok und Codex bis hin zu Claude Sonnet/Opus (T11 bis T12) für Architektur- und Sicherheits-Reviews. Rund 80 % der realen Arbeit landen auf den günstigen, aber leistungsstarken mittleren Stufen.
- Budgetobergrenze mit automatischer Herabstufung: Nähert sich eine Organisation ihrem Limit, weicht das Routing auf günstigere Stufen aus, statt zu blockieren. Ermüdungsbewusst und kaskadierend: Ein fehlgeschlagener Aufruf fällt entlang der Kette zurück.
Deterministische, auf die Absicht abgestimmte Workflows statt bloßer Prompts.
- Protokolle sind YAML-Dateien (maggy/skills/protocols/). Wenn Ihre Absicht einem Protokoll entspricht („push to git“, „ship a feature“), führt Maggy die Schritte der Reihe nach mit echten Gates aus.
- Beispiel git-push: Linting, Typecheck, Tests, Staging, Commit (mit KI-generierter Nachricht), Push. Jeder fehlgeschlagene Schritt stoppt das Protokoll; nichts wird halbfertig ausgeliefert.
- Legen Sie eine .yaml-Datei ab, um eigene hinzuzufügen. 67 mitgelieferte Skills decken Python, TypeScript, React, React Native, Flutter, Supabase, Stripe, Playwright, Sicherheit, ADRs und agentenübergreifende Delegation ab.
Tests zeigen, dass der Code durchläuft; Telos zeigt, dass er seine Absicht erfüllt.
- Telos bewertet Arbeit auf einer Intent Fidelity Scale: IFS = F1 x F2 x F3 über drei Ebenen: Conformance (erfüllt sie die schriftliche Spezifikation), Validation (tut sie das Richtige) und Integrity (ist sie solide und sicher).
- Der Score ist multiplikativ: Eine Null in einer einzigen Ebene lässt den Gesamtwert auf null fallen. Man besteht nicht, indem man zwei Ebenen meistert und die dritte ignoriert.
- Wird als Plugin ausgeliefert und läuft so als fester Teil der Pipeline statt als manueller Nachgedanke.
Ein abfragbarer Code-Graph, den jeder Harness über MCP nutzen kann.
- Cortex erstellt einen Code-Property-Graphen mit 10 Kantentypen, Metriken zur zyklomatischen Komplexität, FTS5-Volltextsuche und bidirektionaler Traversierung, alles in einer einzigen SQLite-Datenbank.
- Es stellt 15 MCP-Tools bereit, sodass Claude Code, Codex oder jeder andere MCP-Client strukturierte Fragen stellen kann („was ruft das auf“, „was würde diese Änderung beschädigen“), anstatt mit grep zu suchen.
- Im Benchmark gegen einfache Codebase-Memory-Ansätze getestet: Graph-Traversierung schlägt flaches RAG bei Fragen nach dem „Warum“ und dem „Blast Radius“.
Mehrere Agenten ohne Dateikonflikte auf einem Repository ausführen.
- Parallele Agenten-Sessions erhalten jeweils einen Docker-isolierten Workspace, der beim Start einer zweiten Session automatisch bereitgestellt wird.
- Da jeder Agent in seinem eigenen isolierten Checkout arbeitet, überschreibt parallele Arbeit niemals die Dateien eines anderen Agenten. Das verhindert den klassischen Fehler beim Einsatz mehrerer Agenten in einem gemeinsamen Repository.
- Über Isolationsmodi bestimmen Sie, wie strikt die Trennung für einen bestimmten Durchlauf ist.
Ein Gedächtnis, das Kompaktierung übersteht und über Wochen erhalten bleibt.
- Mnemos ist ein aufgabenbezogenes Gedächtnis mit einem vierdimensionalen Ermüdungsmodell und typisierten Checkpoints. Es liest Sitzungsprotokolle von Claude Code ein, bewertet, wie „verschwommen“ jede Sitzung ist, und setzt automatisch Checkpoints, bevor Kontext verloren geht.
- Wenn der Kontext komprimiert wird, stellt Mnemos den typisierten Checkpoint wieder her, statt dass Sie die Aufgabe neu erklären müssen. Das spart Token und hält den roten Faden.
- Engram ist die Langzeitschicht: Sie speichert Architekturwissen über Wochen hinweg und fängt sieben verschiedene Arten von „Amnesie“ ab, damit Entscheidungen zwischen Sitzungen nicht verloren gehen.
Speichert, warum Code existiert, nicht nur, was er tut.
- Der um Absichten erweiterte Code Property Graph hält neben der Struktur auch die Begründung hinter dem Code fest: ReasonNodes und Randbedingungen.
- Es erkennt Abweichungen über sechs Dimensionen hinweg und schlägt Alarm, wenn sich eine Implementierung von der ursprünglichen Absicht entfernt hat.
- Und es verhindert doppelte Implementierungen: Bevor Sie etwas Neues bauen, verrät Ihnen der Graph, ob es bereits existiert.
Eine TDD-Pipeline mit sechs Agenten und einer Durchsetzung, die nicht vom bloßen Drandenken abhängt.
- Sechs Rollen bearbeiten jedes Feature: Lead, Quality, Security, Review, Merger und Feature. Eine echte Pipeline, nicht ein einziges Modell für alles.
- Stop-Hooks setzen TDD durch: Tests müssen erfolgreich sein, bevor eine Aufgabe als erledigt gilt. Ohne Grün kein Merge.
- Qualitäts-Gates werden pro Datei durchgesetzt: maximal 20 Zeilen pro Funktion, 3 Parameter und 2 Verschachtelungsebenen. Nicht-triviale Änderungen erfordern ein ADR (das bei Fehlen aus der Git-Historie abgeleitet wird).
Routing: 13 Stufen, das günstigste geeignete Modell gewinnt
Jede Nachricht wird auf einer Skala von 1 bis 10 nach Komplexität bewertet und nach Aufgabentyp klassifiziert (lokal durch Qwen3). Triviale Anfragen bleiben kostenlos und lokal; komplexe Architektur steigt bis zu Claude auf. Mit Budget-Obergrenze und automatischer Rückstufung.
| T0 | Qwen3 (lokal) | Klassifizierung, Triage, kostenlose Massenoperationen |
| T1 | Gemini Flash-Lite | Massenextraktion, Pipelines |
| T2 | DeepSeek Flash | Doku, Tests, Scaffolding |
| T3 | Gemini Flash | Multimodal, Vision, Audio |
| T4 | DeepSeek Pro | Komplexes Coding, Refactorings |
| T5 | Gemini CLI | Agentisches Coding über mehrere Dateien |
| T6 | AGY | End-to-End (Git + Code + Test) |
| T7 | Kimi | Langkontext-Analyse |
| T8 | Gemini Pro Search | Tiefgehende Recherche, 2M Kontext |
| T9 | Grok | Wettbewerbsanalyse, Reasoning |
| T10 | Codex | Massengenerierung, sicherheitskritisch |
| T11 | Claude Sonnet | Qualitätskritischer Code, Debugging |
| T12 | Claude Opus | Architektur, Sicherheit, ADRs |
Plugins: sofort einsatzbereite Erweiterungen
Ein einfaches Plugin-System: einfach einfügen und es klinkt sich in die Events von Maggy ein. Mehrere Plugins sind direkt enthalten.
Verwandelt ausgelieferte Arbeit in Beiträge und veröffentlicht sie auf LinkedIn, X und Reddit, inklusive Voice-Engine (Klartext, keine Gedankenstriche) und einem Heartbeat für Kommentarantworten.
Provider für GitHub, Asana und Monday binden Aufgaben und Issues direkt in den Harness ein.
Telos wird als Plugin mitgeliefert; eigene schreiben Sie mit einer kleinen plugin.yaml und plugin.py.
Was Maggy unterscheidet
Die meisten „KI-Engineering“-Tools sind entweder eine autonome Agentenschleife (im Stil von Hermes), die Ihre CLI ersetzt, oder ein dünner Wrapper ohne Mehrwert. Maggy ist eine Disziplin- und Routing-Schicht, die die Tools erweitert, die Sie bereits nutzen.
| Funktion | Maggy | Frameworks für autonome Agenten | Reines Claude Code |
|---|---|---|---|
| Multi-Modell-Routing | Ja: 13 Stufen, günstigstes fähiges Modell | Meist einzelnes Modell / eigener Loop | Nein: ein Modell für alles |
| Durchgesetzte Disziplin | TDD-Stop-Hooks + Quality Gates + ADRs | Optional, vom Prompt abhängig | Keine |
| Sitzungsübergreifendes Gedächtnis | Engram / Mnemos, übersteht Kompaktierung | Selten / nachträglich angeflanschter Vector Store | Geht nach jeder Sitzung verloren |
| Code-Intelligenz | iCPG + Cortex MCP (warum Code existiert) | Meist einfaches RAG über Dateien | Keine |
| Parallele Sicherheit | Polyphony, Docker-isolierte Workspaces | Manuell / Konflikte im gemeinsamen Repo | k. A. |
| Funktioniert mit Ihrer CLI | Erweitert Claude Code / Codex / Kimi / Gemini | Ersetzt Ihre Tools durch eigene | k. A. |
| Open Source | MIT, 1100+ Tests, selbst hostbar | Variiert | Geschlossen |
Wie es aussieht
You: "review the auth middleware for timing attacks" → Blast score: 8/10 (security + architecture) → Routed to: Claude (Tier 12) → ADR gate: found docs/adr/0003-jwt-strategy.md → injected as context → Review runs with full architectural context You: "push to git" → Intent matched: git-push protocol → ✅ lint · ✅ typecheck · ✅ tests · ✅ commit (AI-written) · ✅ push
Maggy und palgu>
Sie passen zusammen. Maggy ist der Open-Source-Agent-Harness für einzelne Entwickler: lokal, kostenlos, wählt das richtige Modell und setzt Engineering-Disziplin durch. palgu> ist der komplette Engineering-Superharness für Teams: Er steuert das Engineering über alle Agenten und Modelle hinweg, mit den Budgets, Richtlinien und Audits, die ein Unternehmen braucht. Verbinden Sie Claude Code mit einem von beiden; nutzen Sie Maggy allein und kostenlos, und nehmen Sie palgu> hinzu, sobald ein Team Governance braucht. Keines von beiden bindet Sie vertraglich oder technisch (kein Lock-in).