다음은 QMD를 설치하고 현재 옵시디언 볼트를 collection으로 추가하는 프롬프트입니다. macOS 기준입니다. 다른 OS에서는 단계별로 보정이 필요합니다.

사전 조건

• macOS, Homebrew 설치됨
• Node.js 또는 Bun 설치됨 (node -v / bun -v로 확인)
• 옵시디언 볼트 루트 디렉토리에서 터미널 실행 (pwd로 확인)
• RAM 16GB 이상 권장 (로컬 임베딩 모델 구동)

1. QMD 설치

다음 중 하나로 설치:

• npm install -g @tobilu/qmd
• bun install -g @tobilu/qmd

SQLite도 설치:

• brew install sqlite

설치 확인:

• qmd --version
• qmd status

2. 콜렉션 추가

현재 옵시디언 볼트를 obsidian 이름의 컬렉션으로 추가:

• qmd collection add . --name obsidian

등록 확인:

• qmd collection list (또는 qmd collections)

3. 임베딩 모델 변경

기본 모델은 embeddinggemma. 한국어 성능을 위해 Qwen3-Embedding-0.6B로 변경:

export QMD_EMBED_MODEL="hf:Qwen/Qwen3-Embedding-0.6B-GGUF/Qwen3-Embedding-0.6B-Q8_0.gguf"

영구 적용 — 사용 중인 셸 rc 파일에 추가:

• zsh: ~/.zshrc
• bash: ~/.bashrc 또는 ~/.bash_profile

추가 후 source ~/.zshrc로 현재 셸에 반영.

확인:

• echo $QMD_EMBED_MODEL

4. 임베딩

컬렉션 업데이트 및 임베딩 실행:

• qmd update && qmd embed

⚠️ 임베딩 작업 중 CPU/GPU 부하가 크고 시간이 오래 걸립니다. 처음 실행 시 모델 다운로드도 진행되니 네트워크 필요. 완료 후 qmd status로 임베딩 상태 확인.

5. CLAUDE.md 지침 추가

옵시디언 볼트 루트의 CLAUDE.md에 다음 항목을 추가하세요 (없으면 생성):

## Searching Notes
- 키워드 검색: Grep 등 기본 검색 도구 사용
- 의미 기반 검색: CLI에서 `qmd vsearch "<검색어>"` 형태로 사용.

각 단계에서 에러 발생 시 어느 단계·어떤 에러·시도한 해결책·필요한 추가 입력을 명확히 보고할 것.