Dir2md
CLI pipeline that converts codebases into structured markdown context for AI-assisted engineering, review, and documentation workflows.
About This Work
Dir2md packages repository structure, selected code, and documentation into AI-ready markdown while controlling context size, masking sensitive content, and preserving review usefulness.
Repository Overview
Dir2md packages repository structure, selected code, and documentation into AI-ready markdown while controlling context size, masking sensitive content, and preserving review usefulness.
README Core
Dir2md converts directory structures into AI-friendly markdown with intelligent content sampling, security masking, and token-budget control—perfect for AI-assisted development.
New to Dir2md? Check out Wiki.md for a friendly introduction with examples.
v1.2.2 (2026-01-06) - Boundary-safe symlink handling, large-file masking, and deprecation-free pathspec matching:
Use & Documentation
Detailed installation, commands, examples, and deeper usage notes live in the repository README and docs.
README Map
- Quick Start
- Fresh highlights (1.2.2) - Security Hardening & Compatibility
- Security & Reliability
- Configuration System (unchanged, still 1.2.1)
- v1.2.0 Features - Intelligence Without Complexity
- Try Online
Key Signals
- CRITICAL : Symlinked directory traversal now blocked when it escapes root
- CRITICAL : Large-file masking now chunked (no unmasked bypass)
- COMPAT : PathSpec updated to gitignore engine to remove deprecation warnings
- 3-Tier Priority : User CLI Project config System defaults
- pyproject.toml : project-level configuration
Announcements
synced Mar 13, 2026