Claude Code のセッション履歴をベクトル検索できる QMD を入れた

Sat, 18 Apr 2026 23:01:37 +0900

nanoclaw（Claude Code の fork）をアップデートしているとき、内部で QMD が使われているのを見かけた。調べてみたら「お、これ良さそう」となったので入れた。

QMD とは

QMD は、ローカルの Markdown ファイルを対象に検索エンジンを立てる CLI ツール兼 MCP サーバー。単純な grep と違うのは、BM25（キーワード検索）とベクトル検索を組み合わせて意味的に近いドキュメントを引けること。検索用の埋め込みモデルもローカルで動く（GPU がなくても動作する、が後ほど書くけど CPU だとクソ重い処理が一回だけある）。

インストール

本体は以下のように、npm でインストール。

npm install -g @tobilu/qmd

Claude Code はプラグインとして追加する。

claude plugin marketplace add tobi/qmd
claude plugin install qmd@qmd

今回やりたかったことと設定

自分は複数のリポジトリで Claude Code を使っていて、技術的な会話もリポジトリをまたいでいる。そこで、QMD のコレクションに全リポジトリのセッション Markdown を入れておけば、「あのリポジトリでやった話、なんだったっけ」を後から引ける。

同じようなことを実現できるものとして、claude-mem がある。

そもそもこれ入れればいいじゃんって話もあるけど、なんか分からんけど直感で QMD いいかもって思ってしまったので仕方ない。直感で突き進みます。

まずは、Claude のセッションをマークダウンに変換するスクリプト convert-sessions.js を用意して、~/.claude/hooks 配下に配置。

Claude Code 使い始めたのが割と最近なので、セッション数も100ほど。これをまず全部マークダウンへ変換して、~/.cache/qmd-sessions へ配置する。

そして、このディレクトリを QMD へ食わせる。

qmd collection add ~/.cache/qmd-sessions --name claude-sessions

これだけだと過去のセッションだけの登録になってしまうので、終わったセッションを片っ端から食わせるために、Stop hook に仕掛けを入れた。

MCP on 大体動かない

Claude Code のセッション履歴をベクトル検索できる QMD を入れた

QMD とは

インストール

今回やりたかったことと設定