# Show GN: dir2md v1.0.4 — 오픈소스 코드베이스를 LLM-Friendly Markdown으로 변환하는 CLI, 대규모 업데이트

> Clean Markdown view of GeekNews topic #23568. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=23568](https://news.hada.io/topic?id=23568)
- GeekNews Markdown: [https://news.hada.io/topic/23568.md](https://news.hada.io/topic/23568.md)
- Type: show
- Author: [flamehaven01](https://news.hada.io/@flamehaven01)
- Published: 2025-10-10T23:06:04+09:00
- Updated: 2025-10-10T23:06:04+09:00
- Original source: [github.com/Flamehaven](https://github.com/Flamehaven/dir2md/)
- Points: 8
- Comments: 0

## Summary

로컬 및 리모트 **코드베이스**를 **LLM** 입력에 최적화된 **Markdown**으로 변환하는 오픈소스 CLI 툴 dir2md가 주요 업데이트를 통해 **성능 최적화**, **보안 마스킹** 강화, 그리고 더 직관적인 **옵션 관리**를 제공합니다. 최신 버전에서는 **테스트 및 실행 환경 자동화**와 **gitwildmatch 패턴**의 정밀한 복원으로 대규모 프로젝트에서도 효율적으로 동작합니다. 다양한 인증 정보와 민감 데이터 자동 감춤, **프리셋 기반 성능 개선** 및 설정 단순화까지 지원하여 개발자와 AI 활용에 특화된 문서화 워크플로우 구축에 도움을 줍니다.

## Topic Body

### 🔥 dir2md v1.0.4 — 오픈소스 코드베이스를 LLM-Friendly Markdown으로 변환하는 CLI, 대규모 업데이트  
  
> dir2md는 로컬 또는 리모트 저장소를 스캔해, 디렉터리 구조 + 파일 콘텐츠를 **LLM 입력에 최적화된 Markdown 블루프린트**로 만들어주는 오픈소스 CLI 툴입니다.  
>   
> 코드 리뷰, AI 문서화, 프롬프트 엔지니어링 등에서 유용하게 활용할 수 있습니다.  
>   
> 🔗 GitHub: [https://github.com/Flamehaven/dir2md](https://github.com/Flamehaven/dir2md?utm_source=chatgpt.com)  
>   
> 🔗 Release v1.0.4: [https://github.com/Flamehaven/dir2md/releases/tag/v1.0.4](https://github.com/Flamehaven/dir2md/releases/tag/v1.0.4?utm_source=chatgpt.com)  
>   
  
---  
  
#### 주요 개선 사항 (v1.0.3 → v1.0.4)  
  
##### ⚙️ **CLI 구성 및 옵션 처리 개선 (General Availability)**  
  
- CLI 기본 설정이 정식 GA 수준으로 안정화됨.  
- 주요 옵션(`-preset`, `-mask`, `-exclude` 등)의 동작이 명확하게 정리되어  
    
    버전별 동작 차이 없이 일관된 출력 보장.  
    
- 불필요한 경고 메시지 및 중복 안내 제거.  
  
  
##### 🧠 **로컬 실행 및 테스트 환경 자동화**  
  
- **Repository-level import helper** 추가.  
    
    → `pytest`나 로컬 실행 시 `src/` 디렉터리 자동 인식,  
    
    더 이상 `pip install -e .` (editable install) 필요 없음.  
    
- 테스트 환경 설정 단순화, 로컬 개발 효율성 향상.  
  
  
##### 🔍 **Glob 매칭 복원 (`gitwildmatch` semantics)**  
  
- `*/` 패턴이 루트 파일까지 매칭되는 문제 수정.  
    
    → Git의 `gitwildmatch` 동작을 정확히 복원하여  
    
    재귀적 glob 검색이 직관적으로 동작하도록 개선.  
    
- 대규모 리포지토리 스캔 시 예기치 않은 파일 누락 또는 과잉 탐색 방지.  
  
  
##### 🛡️ **보안 마스킹 및 설정 강화**  
  
- 기본 마스킹 범위 확대:  
    - GitHub PAT (`ghp_`, `gho_`, `ghs_` 등)  
    - API Key, JWT, Database URL, OAuth Secret 등 민감 정보 자동 감춤.  
- `.env` 파일 자동 로드 기능 추가:  
    
    CLI 실행 시 근접한 `.env` 파일을 탐색 및 적용.  
    
- 사용자 정의 마스킹 패턴 지원:  
    - CLI 옵션: `-mask-pattern`, `-mask-pattern-file`  
    - 프로젝트 설정: `pyproject.toml`의 `[tool.dir2md.masking]`  
  
  
##### ⚡️ **성능 및 프리셋 최적화 (Pro Mode)**  
  
- **Pro preset** 실행 시 성능 중심 가이드 반영:  
    - 불필요한 파일 제외(Targeted excludes)  
    - 토큰 예산(Tight budgets) 자동 계산  
    - Manifest 생성 스킵 옵션 추가로 대규모 프로젝트 처리 속도 개선.  
- 내부 캐싱 및 IO 효율 개선 → 평균 실행 속도 약 15~25% 향상.  
  
  
##### 🧾 **호환성 및 안정성**  
  
- Windows 환경에서 `file:///C:/path` URI 처리 버그 수정.  
- CP949 등 비 UTF-8 로케일 환경에서도 ASCII-safe 출력 보장.  
- Symlink 미지원 환경에서 일부 테스트 자동 스킵.  
- 나머지 테스트 전부 통과   
  
---  
  
#### 🧭 **한 줄 요약**  
  
> dir2md v1.0.4 = 보안 강화 + 성능 향상 + 설정 단순화  
>   
>   
> LLM-friendly 코드 요약 파이프라인을 만들고 싶다면 지금 바로 업데이트!  
>

## Comments



_No public comments on this page._