claudegoodies
Skill

qmd

From NousResearch

Search personal knowledge bases, notes, docs, and meeting transcripts locally using qmd — a hybrid retrieval engine with BM25, vector search, and LLM reranking. Supports CLI and MCP integration.

Indexes local markdown/text files and searches them via BM25, vector embeddings, and LLM reranking through a CLI or MCP server.

Use it when

  • Searching personal notes, docs, or meeting transcripts across many files
  • Need semantic 'find notes about X concept' search, not just grep
  • Already have qmd collections set up and want to query them
  • Setting up a local, offline knowledge-base search system

Skip it if

  • Requires Node.js >= 22 and ~2GB of GGUF models downloaded on first run
  • macOS needs Homebrew SQLite since system SQLite lacks extension loading
  • Only need simple grep/ripgrep-style exact text search

Facts

Repository
NousResearch/hermes-agent
Status
Actively maintained
Last commit
Source file
optional-skills/research/qmd/SKILL.md

Source preview

The instructions Claude Code reads when this skill runs.

# QMD — Query Markup Documents

Local, on-device search engine for personal knowledge bases. Indexes markdown
notes, meeting transcripts, documentation, and any text-based files, then
provides hybrid search combining keyword matching, semantic understanding, and
LLM-powered reranking — all running locally with no cloud dependencies.

Created by [Tobi Lütke](https://github.com/tobi/qmd). MIT licensed.

## When to Use

- User asks to search their notes, docs, knowledge base, or meeting transcripts
- User wants to find something across a large collection of markdown/text files
- User wants semantic search ("find notes about X concept") not just keyword grep
- User has already set up qmd collections and wants to query them
- User asks to set up a local knowledge base or document search system
- Keywords: "search my notes", "find in my docs", "knowledge base", "qmd"

## Prerequisites

### Node.js >= 22 (required)

```bash
# Check version
node --version  # must be >= 22

# macOS — install or upgrade via Homebrew
brew install node@22

# Linux — use NodeSource or nvm
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# or with nvm:
nvm install 22 && nvm use 22
```

### SQLite with Extension Support (macOS only)

macOS system SQLite lacks extension loading. Install via Homebrew:

```bash
brew install sqlite
```

### Install qmd

```bash
npm
View full source on GitHub →

Other skills