# qmd - GitHub Repository (tobi/qmd)

> Source: https://github.com/tobi/qmd
> Retrieved: 2026-09-02, via `https://api.github.com/repos/tobi/qmd`,
> `https://api.github.com/repos/tobi/qmd/languages`, and the raw README/`package.json` at the
> `main` branch HEAD (`pushed_at: 2026-08-18T14:26:31Z` at retrieval time).
> Fidelity: the API JSON fields are quoted verbatim; the README/package.json excerpts below are
> quoted verbatim from the fetched files, trimmed to what backs the corrected claims on
> `kb/entities/tools/qmd.md` - not a full copy of either file.

## Repository metadata (GitHub API)

```json
{
  "full_name": "tobi/qmd",
  "description": "mini cli search engine for your docs, knowledge bases, meeting notes, whatever. Tracking current sota approaches while being all local",
  "language": "TypeScript",
  "html_url": "https://github.com/tobi/qmd",
  "license": {"key": "mit", "name": "MIT License", "spdx_id": "MIT"}
}
```

Byte-weighted language breakdown (`/languages` endpoint):

```json
{
  "TypeScript": 1597168,
  "Python": 200880,
  "Shell": 26136,
  "JavaScript": 23132,
  "Nix": 5984,
  "Just": 1081,
  "Dockerfile": 1074
}
```

## `package.json` dependencies

```json
{
  "name": "@tobilu/qmd",
  "dependencies": {
    "@modelcontextprotocol/server": "2.0.0",
    "better-sqlite3": "^13.0.3",
    "fast-glob": "3.3.3",
    "node-llama-cpp": "3.20.0",
    "picomatch": "4.0.5",
    "sqlite-vec": "0.1.9",
    "tree-sitter-go": "0.25.0",
    "tree-sitter-python": "0.25.0",
    "tree-sitter-rust": "0.24.0",
    "tree-sitter-typescript": "0.23.2",
    "web-tree-sitter": "0.26.12",
    "yaml": "2.9.0",
    "zod": "4.2.1"
  }
}
```

## README excerpts

Opening description (README.md, line 5):

> QMD combines BM25 full-text search, vector semantic search, and LLM re-ranking—all running
> locally via node-llama-cpp with GGUF models.

Install ("Quick Start" section):

```sh
# Install globally (Node or Bun)
npm install -g @tobilu/qmd
# or
bun install -g @tobilu/qmd

# Or run directly
npx @tobilu/qmd ...
bunx @tobilu/qmd ...
```

Scoring table (architecture section):

| Stage | Method | Formula | Range |
|---|---|---|---|
| FTS (BM25) | SQLite FTS5 BM25 | `Math.abs(score)` | 0 to ~25+ |
| Vector | Cosine distance | `1 / (1 + distance)` | 0.0 to 1.0 |
| Reranker | LLM 0-10 rating | `score / 10` | 0.0 to 1.0 |

Diagnostic command comment, confirming `sqlite-vec` is the vector index used at runtime, not
only a listed dependency:

```
# Diagnose the install (runtime, sqlite-vec, embedding fingerprints, GPU probe)
```

## Not extracted

The full README (1301 lines: library API, MCP server usage, tree-sitter code-chunking options,
config file reference, CLI subcommand reference) - only the excerpts backing the corrected
`qmd.md` claims (language, runtime, install method, search/rerank stack) were pulled. A future
qmd page expansion covering its library API or MCP server would need a fresh fetch, not a reuse
of this file's `## Not extracted` judgment.