dir2md v1.0.4 — CLI zur Umwandlung von Open-Source-Codebasen in LLM-friendly Markdown, großes Update

🔥 dir2md v1.0.4 — CLI zur Umwandlung von Open-Source-Codebasen in LLM-friendly Markdown, großes Update

dir2md ist ein Open-Source-CLI-Tool, das lokale oder Remote-Repositories scannt und die Verzeichnisstruktur plus Dateiinhalte in einen für LLM-Eingaben optimierten Markdown-Blueprint umwandelt.

Es lässt sich unter anderem für Code-Reviews, AI-Dokumentation und Prompt Engineering nützlich einsetzen.

🔗 GitHub: https://github.com/Flamehaven/dir2md

🔗 Release v1.0.4: https://github.com/Flamehaven/dir2md/releases/tag/v1.0.4

---

Wichtige Verbesserungen (v1.0.3 → v1.0.4)

⚙️ Verbesserungen bei CLI-Konfiguration und Optionsverarbeitung (General Availability)

• Die Standardkonfiguration der CLI wurde auf ein stabiles GA-Niveau gebracht.

• Das Verhalten wichtiger Optionen (-preset, -mask, -exclude usw.) wurde klarer definiert, sodass

  eine konsistente Ausgabe ohne versionsbedingte Unterschiede gewährleistet ist.

• Unnötige Warnmeldungen und doppelte Hinweise wurden entfernt.

🧠 Automatisierung für lokale Ausführung und Testumgebung

• Repository-level import helper hinzugefügt.

  → Bei pytest oder lokaler Ausführung wird das Verzeichnis src/ automatisch erkannt,

  pip install -e . (editable install) ist nicht mehr erforderlich.

• Die Konfiguration der Testumgebung wurde vereinfacht, was die Effizienz in der lokalen Entwicklung verbessert.

🔍 Wiederherstellung von Glob-Matching (gitwildmatch semantics)

• Ein Problem wurde behoben, bei dem das Muster */ auch Dateien im Root-Verzeichnis matchte.

  → Das Verhalten von Git gitwildmatch wurde präzise wiederhergestellt,

  sodass rekursive Glob-Suchen intuitiver funktionieren.

• Verhindert unerwartet fehlende Dateien oder übermäßiges Scannen bei großen Repositories.

🛡️ Stärkeres Security-Masking und Konfiguration

• Der standardmäßige Maskierungsumfang wurde erweitert:

  • GitHub-PATs (ghp_, gho_, ghs_ usw.)
  • API Keys, JWTs, Database URLs, OAuth Secrets und weitere sensible Informationen werden automatisch verborgen.

• Automatisches Laden von .env-Dateien hinzugefügt:

  Beim Ausführen der CLI werden nahegelegene .env-Dateien gesucht und angewendet.

• Unterstützung für benutzerdefinierte Maskierungsmuster:

  • CLI-Optionen: -mask-pattern, -mask-pattern-file
  • Projektkonfiguration: [tool.dir2md.masking] in pyproject.toml

⚡️ Performance- und Preset-Optimierungen (Pro Mode)

• Beim Ausführen des Pro preset wurden performanceorientierte Leitlinien übernommen:
  • Ausschluss unnötiger Dateien (Targeted excludes)
  • Automatische Berechnung enger Token-Budgets (Tight budgets)
  • Eine zusätzliche Option zum Überspringen der Manifest-Erstellung verbessert die Verarbeitungsgeschwindigkeit großer Projekte.
• Internes Caching und IO-Effizienz wurden verbessert → durchschnittliche Ausführungsgeschwindigkeit um etwa 15–25 % gesteigert.

🧾 Kompatibilität und Stabilität

• Ein Bug bei der Verarbeitung von file:///C:/path-URIs unter Windows wurde behoben.
• ASCII-sichere Ausgabe auch in Nicht-UTF-8-Locale-Umgebungen wie CP949 gewährleistet.
• Einige Tests werden in Umgebungen ohne Symlink-Unterstützung automatisch übersprungen.
• Alle übrigen Tests bestanden.

---

🧭 Kurz zusammengefasst

dir2md v1.0.4 = mehr Sicherheit + bessere Performance + einfachere Konfiguration

Wenn du eine LLM-friendly Pipeline zur Code-Zusammenfassung bauen willst, aktualisiere jetzt!