/ Verzeichnis / Playground / mex
← Alle Server ↗ GitHub
● Community theDakshJaitly ⚡ Sofort

mex

von theDakshJaitly · theDakshJaitly/mex

Projektgedächtnis-Gerüst + Drift-Detektor — hält KI-Coding-Agenten im tatsächlichen Projektzustand geerdet, nicht im gestrigen Snapshot.

mex installiert ein strukturiertes Gedächtnisgerüst in deinem Repo (Architektur, Konventionen, laufende Arbeit, Blocker) und liefert ein CLI, das Drift zwischen Gedächtnis und Realität erkennt. Wenn Code-Änderungen dem Gedächtnis widersprechen, signalisiert das CLI es damit du aktualisieren oder neu ausrichten kannst. Leichtgewichtig — soll im Repo leben und mit dem Team reisen.

▶ Demo ansehen 📦 Installieren 💡 Anwendungsfälle

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

bereit

Installation

Repository des Autors · Offizielle Dokumentation zu Claude Skills

Anwendungsfälle

Praxisnahe Nutzung: mex

Projektgedächtnis am Anfang eines Projekts einrichten

👤 Neue Repo-Eigentümer ⏱ ~25 min beginner

Wann einsetzen: Tag 1 eines Projekts; du willst, dass Agenten schnell produktiv werden.

Ablauf
  1. Initialisieren
    Use mex. Initialize project memory with sections: architecture, conventions, in-flight, blockers.✓ Kopiert
    → /.mex/-Gerüst mit Templates erstellt
  2. Startinhalte befüllen
    Auto-extract architecture from existing code and a starter convention list.✓ Kopiert
    → Abschnitte mit Starterinhalt befüllt
  3. Frischheit setzen
    Mark each section verified today.✓ Kopiert
    → Frischheitsmarkierungen gesetzt

Ergebnis: Neues Projekt startet mit geteiltem Agentenkontext.

Fallstricke
  • Auto-Extraktion zieht irrelevante Details — Rigoros trimmen — Gedächtnis ist für Prinzipien, nicht für grep-Output
Kombinieren mit: filesystem

Herausfinden wo Projektgedächtnis und Code sich widersprechen

👤 Langfristige Projekt-Eigentümer ⏱ ~30 min intermediate

Wann einsetzen: Gedächtnis wurde vor Monaten eingerichtet; niemand weiß wie veraltet es ist.

Ablauf
  1. Drift ausführen
    Use mex. Run drift detection. Report claims that no longer match reality.✓ Kopiert
    → Drift-Report mit Behauptung ↔ Evidenz
  2. Aktualisieren oder entfernen
    For each drift, decide: update memory or fix the code (claim was right and reality drifted).✓ Kopiert
    → Pro-Element-Entscheidung; PRs für code-seitige Fixes geöffnet
  3. Neu verifizieren
    After resolving, mark sections verified today.✓ Kopiert
    → Gedächtnis wieder ausgerichtet

Ergebnis: Gedächtnis bleibt verlässlicher Vertrag, kein Folkloreerzählung.

Fallstricke
  • Drift-Detektor schlägt zu aggressiv an — --strictness anpassen; 'medium' für lebende Projekte verwenden
Kombinieren mit: github

Laufende Arbeit zwischen Teammitgliedern übergeben

👤 Entwickler im Urlaub / beim Verlassen ⏱ ~20 min beginner

Wann einsetzen: Du hast 3 Features in Arbeit und jemand anderes muss übernehmen.

Ablauf
  1. Laufendes erfassen
    Use mex. For each open branch, write an in-flight entry: goal, current state, next steps, gotchas.✓ Kopiert
    → Einträge in /.mex/in-flight/
  2. Mit CLI verifizieren
    Run drift on in-flight; ensure entries reflect actual branch state.✓ Kopiert
    → Drift sauber
  3. Übergeben
    Generate a teammate-ready summary linking each entry to its branch.✓ Kopiert
    → Slack/E-Mail-fähige Übergabe

Ergebnis: Reibungslose Übernahme; kein Archäologie-Betrieb nötig.

Fallstricke
  • In-flight-Einträge vage ('arbeite an X') — 'Nächste Schritte'-Feld im Template erzwingen; konkret oder es hilft nicht

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

mex-skill + filesystem

Gedächtnis lebt im Repo; committen

Commit /.mex/ to git so memory travels with the codebase.✓ Kopiert
mex-skill + github

Drift-CI-Check bei PRs

On every PR, run mex drift and post the report as a PR comment.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
init scaffold_options Einmal pro Projekt 0
drift section?, strictness? Wöchentlich / vor dem Mergen langfristiger Branches 0 (lokale Checks + LLM für vage Behauptungen)
verify section Nach dem Aktualisieren des Gedächtnisses zur Realität 0
in_flight_add branch, goal, next_steps Beim Starten eines Feature-Branches 0
summary format Übergabe / Statusbericht 0

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
Keine — lokal
Tokens pro Aufruf
Drift nutzt LLM für vage Behauptungen; pro Lauf begrenzt
Kosten in €
Kostenlos
Tipp
strict=high in CI für echten Drift; medium für tägliche lokale Checks

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: filesystem-write
Credential-Speicherung: Keine
Datenabfluss: Keine sofern Drift-LLM nicht auf Remote-Provider konfiguriert

Fehlerbehebung

Häufige Fehler und Lösungen

Drift meldet Falsch-Positive

Strenge verringern; oder Behauptungsformulierung prüfbarer gestalten

Gedächtnis wächst unbegrenzt

Jeder Abschnitt hat ein weiches Limit; periodisch konsolidieren — Prinzipien behalten, Spezifisches archivieren

CLI findet /.mex/ nicht

Vom Repo-Stammverzeichnis ausführen; oder --root <path> übergeben

Auto-Extraktion übersieht wichtige Invarianten

Auto-Extraktion ist ein Starter; tragende Invarianten manuell schreiben

Alternativen

mex vs. andere

AlternativeWann stattdessenKompromiss
claude-mem-skillSitzungskontinuität gewünscht, kein ProjektwissensgedächtnisAnderes Problem; mex ist für Projektebene-Invarianten
Plain CLAUDE.mdKleines Projekt, kein Drift-Detection nötigKeine Struktur; keine automatischen Frischheitsprüfungen
pilot-shell-skillSpec/Plan/Gates plus Wissenspersistenz gewünschtGrößere Workflow-Oberfläche; mehr Meinungen

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen