qmd

개요

https://github.com/tobi/qmd

설치

WSL2 에서

npm install -g @tobilu/qmd

qmd 명령어 실행 가능하도록 PATH 설정되었는지 확인

프로젝트별 설정

• 프로젝트 별로 root directory 에 note 디렉토리 생성

  mkdir note

• qmd 에서 note 디렉토리를 collection 으로 인식할 수 있도록 한다. Claude Code 에서 /export 를 하면 txt 확장자로 저장되기 때문에 txt 파일도 읽을 수 --mask 옵션을 준다.

  qmd collection add /mnt/c/work/my-proj/note --name my-proj --mask  "**/*.{md,txt}"
  qmd context add qmd://my-proj "my notes"

• ~/.config/qmd/index.yml 파일 확인

  collections:
   my-proj:
     path: /mnt/c/work/my-proj/note
     pattern: "**/*.{md,txt}"

• Claude Code 에서 context /export

  /export note/my-context-file-name

• Generate embeddings for semantic search

  qmd update && qmd embed 

• Get, Search, ...

  qmd --help
  qmd status                                # Show index status and collections
  qmd collection list
  
  qmd search "project timeline" -c my-proj  # Fast keyword search, -c specific collection
  qmd vsearch "how to deploy"               # Semantic search
  
  qmd get "note/my-context-file-name"

• 추가 command 는 https://github.com/tobi/qmd/blob/main/CLAUDE.md 를 참고.

• /export 후에는 qmd update & qmd embed 를 실행함.

  • update: collection 에 추가/삭제 된 파일을 인지함
  • embed: 변경된 파일(추가, 삭제포함) 색인