vaultweaver은(는) 무엇을 하나요?
파일을 Claude Code용 지식 그래프로 변환합니다. 로컬 데이터에서 구조화된 LLM 인덱스를 구축하는 Obsidian 호환 도구입니다.
개요
VaultWeaver는 로컬 파일 시스템의 데이터를 읽어 Claude Code가 효율적으로 탐색하고 검색할 수 있는 지식 그래프로 변환합니다. Obsidian 볼트와 원활하게 통합되어 기존 마크다운 노트와 파일에서 링크된 지식 구조를 자동 생성합니다.
주요 기능
- 지식 그래프 생성: 파일과 디렉터리를 노드와 관계로 매핑하여 구조화된 그래프 생성
- Obsidian 호환성: Obsidian 마크다운 형식 및 내부 링크를 지원하며, 기존 볼트 구조를 유지함
- LLM 인덱싱: Claude Code가 빠르게 조회할 수 있는 임베딩 기반 인덱스 구축
- 증분 업데이트: 변경된 파일만 다시 인덱싱하여 성능 최적화
사용 방법
# 볼트 디렉터리 지정하여 지식 그래프 생성
vaultweaver --vault /path/to/obsidian-vault --output ./knowledge-graph
# Claude Code와 함께 사용
claude --vault ./knowledge-graph
설정
vaultweaver.config.json 파일을 통해 동작을 사용자 정의할 수 있습니다:
{
"vaultPath": "/path/to/vault",
"outputDir": "./knowledge-graph",
"excludePatterns": ["node_modules", ".git"],
"embeddingModel": "text-embedding-3-small",
"chunkSize": 512,
"chunkOverlap": 128
}
지원 환경
- Claude Code (CLI)
- Obsidian (플러그인 또는 직접 볼트 통합)
- 모든 주요 OS (macOS, Linux, Windows)
라이선스
MIT