dir2md v1.0.4 — actualización importante del CLI que convierte codebases open source a Markdown compatible con LLM

🔥 dir2md v1.0.4 — actualización importante del CLI que convierte codebases open source a Markdown compatible con LLM

dir2md es una herramienta CLI open source que escanea repositorios locales o remotos y convierte la estructura de directorios + el contenido de archivos en un blueprint Markdown optimizado para la entrada de LLM.

Puede aprovecharse de forma útil en revisión de código, documentación con IA, prompt engineering y más.

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

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

---

Principales mejoras (v1.0.3 → v1.0.4)

⚙️ Mejoras en la configuración del CLI y el manejo de opciones (General Availability)

• La configuración base del CLI se estabilizó a nivel de GA formal.

• El comportamiento de opciones principales (-preset, -mask, -exclude, etc.) quedó claramente organizado,

  garantizando una salida consistente sin diferencias de comportamiento entre versiones.

• Se eliminaron mensajes de advertencia innecesarios y avisos duplicados.

🧠 Automatización de ejecución local y entorno de pruebas

• Se agregó un repository-level import helper.

  → Al ejecutar pytest o correrlo localmente, el directorio src/ se reconoce automáticamente,

  por lo que ya no hace falta pip install -e . (editable install).

• Se simplificó la configuración del entorno de pruebas y mejoró la eficiencia del desarrollo local.

🔍 Restauración del matching de glob (gitwildmatch semantics)

• Se corrigió el problema donde el patrón */ también hacía match con archivos en la raíz.

  → Se restauró con precisión el comportamiento gitwildmatch de Git para que

  las búsquedas glob recursivas funcionen de forma más intuitiva.

• Evita omisiones inesperadas de archivos o exploraciones excesivas al escanear repositorios grandes.

🛡️ Refuerzo de seguridad y configuración de masking

• Se amplió el alcance del masking por defecto:

  • GitHub PAT (ghp_, gho_, ghs_, etc.)
  • información sensible como API Key, JWT, Database URL y OAuth Secret se oculta automáticamente.

• Se agregó carga automática de archivos .env:

  al ejecutar el CLI, busca y aplica archivos .env cercanos.

• Soporte para patrones de masking definidos por el usuario:

  • opción CLI: -mask-pattern, -mask-pattern-file
  • configuración del proyecto: [tool.dir2md.masking] en pyproject.toml

⚡️ Optimización de rendimiento y presets (Pro Mode)

• Al ejecutar el preset Pro, se incorporaron guías enfocadas en rendimiento:
  • exclusión de archivos innecesarios (Targeted excludes)
  • cálculo automático de presupuestos de tokens (Tight budgets)
  • mejora de velocidad en proyectos grandes con una nueva opción para omitir la generación de manifest.
• Mejoras en caché interna y eficiencia de IO → velocidad promedio de ejecución aproximadamente 15~25% mayor.

🧾 Compatibilidad y estabilidad

• Se corrigió un bug en el manejo de URIs file:///C:/path en Windows.
• Se garantiza salida segura en ASCII incluso en entornos locale no UTF-8 como CP949.
• Algunas pruebas se omiten automáticamente en entornos sin soporte para symlink.
• El resto de las pruebas pasan por completo.

---

🧭 Resumen en una línea

dir2md v1.0.4 = más seguridad + mejor rendimiento + configuración más simple

Si quieres crear un pipeline de resumen de código compatible con LLM, ¡actualiza ahora mismo!