Troubleshooting¶

# Use module directly
python -m folder2md4llms .

# Or ensure pipx is in PATH
pipx ensurepath

pipx install folder2md4llms
# or
pip install --user folder2md4llms

python --version

# Validate YAML syntax
folder2md --config folder2md.yaml --dry-run

# Test patterns
folder2md --dry-run --include-pattern "src/**/*.py"

# Use ** for subdirectories
folder2md --include-pattern "**/*.py"  # ✓
folder2md --include-pattern "*.py"     # Only root level

# Use verbose mode to identify issues
folder2md --verbose .

# Exclude problematic files/directories
folder2md --exclude-pattern "**/problem-dir/**" .

# Reduce file size limit
folder2md --max-file-size 100000 .

# Use aggressive condensing
folder2md --smart-condensing --condense-strategy aggressive .

# Set token limit with smart condensing
folder2md --smart-condensing --token-limit 80000 .

# Use aggressive strategy
folder2md --smart-condensing --condense-strategy aggressive .

# Exclude problematic documents
folder2md --exclude-pattern "**/*.pdf" .

# Check dependencies
pip install python-docx openpyxl pypdf

# Disable update checks
export FOLDER2MD_UPDATE_CHECK=false

# Enable verbose mode
folder2md --verbose .

# Test with dry run
folder2md --dry-run .

# Start minimal and add features incrementally
folder2md --output test.md src/