qmd-search

Search local markdown notes and Claude session history using BM25 indexing.

Updated Oct 27, 2025

Search Tags:#documentation #markdown #search #notes #local #BM25 #claude-sessions

Ready to run

npx skills add https://github.com/SomtoUgeh/dotfiles --skill qmd-search

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: qmd-search
Source: https://github.com/SomtoUgeh/dotfiles/tree/main/claude/skills/qmd-search
Command: npx skills add https://github.com/SomtoUgeh/dotfiles --skill qmd-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables fast local search across markdown notes, documentation, and Claude session history.

Core Features & Use Cases

Fast keyword search: Quickly locate relevant markdown content using BM25 indexing.
Full-document retrieval: Retrieve complete files with precise context.
Collection-specific queries: Target searches to particular note collections or folders.

Quick Start

Use the qmd search command to find "authentication flow" across local markdown notes. To retrieve a full document, run: qmd get "path/to/file.md" To search within a specific collection, run: qmd search "react hooks" -c claude-sessions

Frequently Asked Questions about qmd-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I search across local markdown notes and documentation?▼

To search local markdown notes, use the qmd search command with your query. It uses BM25 indexing to quickly locate relevant markdown files and documentation, returning snippets or full documents based on your needs.

Can I search for specific keywords within a single collection of notes?▼

Yes, you can search within a specific collection by using the -c flag. For example, running qmd search "react hooks" -c claude-sessions limits the keyword search to only that particular folder or collection.

How do I retrieve a full markdown document after finding it in search?▼

To retrieve a full markdown document, use the qmd get command followed by the file path. This returns the complete file content with precise context, rather than just a short snippet.

Does local note search support vector-based queries or only keyword matching?▼

Local note search primarily relies on BM25 keyword indexing for fast results. However, it includes an optional vector-based search as an advanced mode for users needing semantic matching alongside the default keyword approach.

Can I search through my Claude session history using this tool?▼

Yes, you can search across your Claude session history. By targeting the claude-sessions collection, the BM25 indexing locates relevant keywords and content directly from your past session logs.