qmd CLAUDE.md

qmd CLAUDE.md is an instructions file for coding agents from ehc-io/qmd. It costs 1,413 tokens per session, scanned A, original, MIT.

Command instructions for QMD, a tool that organizes and searches collections of documents. They cover using Bun, creating collections, adding context, retrieving files, and checking index status.

In plain words
What is it for?
Creating, listing, renaming, updating, searching, and retrieving indexed document collections.
Why use it?
They provide the exact commands and package manager needed to manage document collections without confusing QMD’s workflow with a standard Node.js project.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/ehc-io/qmd/claude-md
Clone the repo
git clone --depth 1 https://github.com/ehc-io/qmd

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for qmd CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/ehc-io/qmd/claude-md.svg)](https://agentmods.dev/instructions/ehc-io/qmd/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/ehc-io/qmd/claude-md"><img src="https://agentmods.dev/badge/instructions/ehc-io/qmd/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,413 This file is loaded in full into every session.
When invoked 1,413 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01413 $0.01413
Opus 5 $0.00707 $0.00707
Sonnet 5 $0.00283 $0.00283
Haiku 4.5 $0.00141 $0.00141

Measured 5d ago against content hash 15c33aa17b46, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

qmd CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 166 lines

How it starts

The opening of the file, as written. The whole thing — 166 lines — stays where its author put it; the contents beside it link to each section on GitHub.

QMD - Query Markup Documents

Use Bun instead of Node.js (bun not node, bun install not npm install).

Commands

qmd collection add . --name <n>   # Create/index collection
qmd collection list               # List all collections with details
qmd collection remove <name>      # Remove a collection by name
qmd collection rename <old> <new> # Rename a collection
qmd ls [collection[/path]]        # List collections or files in a collection
qmd context add [path] "text"     # Add context for path (defaults to current dir)
qmd context list                  # List all contexts
qmd context check                 # Check for collections/paths missing context
qmd context rm <path>             # Remove context
qmd get <file>                    # Get document by path or docid (#abc123)
qmd multi-get <pattern>           # Get multiple docs by glob or comma-separated list
qmd status                        # Show index status and collections
qmd update [--pull]               # Re-index all collections (--pull: git pull first)
qmd embed                         # Generate vector embeddings (uses node-llama-cpp)
qmd query <query>                 # Search with query expansion + reranking (recommended)
qmd search <query>                # Full-text keyword search (BM25, no LLM)
qmd vsearch <query>               # Vector similarity search (no reranking)
qmd mcp                           # Start MCP server (stdio transport)
qmd mcp --http [--port N]         # Start MCP server (HTTP, default port 8181)
qmd mcp --http --daemon           # Start as background daemon
qmd mcp stop                      # Stop background MCP daemon

Collection Management

# List all collections
qmd collection list

# Create a collection with explicit name
qmd collection add ~/Documents/notes --name mynotes --mask '**/*.md'

# Remove a collection
qmd collection remove mynotes

# Rename a collection
qmd collection rename mynotes my-notes

# List all files in a collection
qmd ls mynotes

# List files with a path prefix
qmd ls journals/2025
qmd ls qmd://journals/2025

Read the full file on GitHub · 166 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 166 lines · 1,413 tokens per session scan A 15c33aa17b46

Subscribe to this mod's changes

qmd CLAUDE.md is an instructions file published in the GitHub repository ehc-io/qmd (16 stars, last pushed 6mo ago), licensed MIT. It adds 1,413 tokens to every session, about $0.0071 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

mcp-pandoc AGENTS.md

Instructions for vivekVells/mcp-pandoc, covering agents.md, what this is, where things are, deeper context and commands.

vivekVells/mcp-pandoc · 1,019 tokens

agentic-resume-builder CLAUDE.md

Claude Code instructions for WtotdeD/agentic-resume-builder, covering agentic-resume-builder development guidelines, what this repo is, active technologies, package manager and validation.

WtotdeD/agentic-resume-builder · 695 tokens

fcp-sheets CLAUDE.md

Instructions for os-tack/fcp-sheets, covering fcp-sheets, project overview, architecture, key patterns and commands.

os-tack/fcp-sheets · 308 tokens

rodya-caijing-studio AGENTS.md

AGENTS.md instructions for nekopunch11/rodya-caijing-studio, covering rodya-caijing-studio · 给 ai agent 的使用说明, 入口与路由, 不可破的硬约束(合规灵魂,破了整套工具就失效), docx 渲染路由(财经内容台例外) and 在 codex 中安装.

nekopunch11/rodya-caijing-studio · 1,489 tokens

paperless-ngx-mcp-server CLAUDE.md

Claude Code instructions for cbsmiley/paperless-ngx-mcp-server, covering claude.md, project overview, common commands, architecture and entry points.

cbsmiley/paperless-ngx-mcp-server · 769 tokens

hermes-procurement-pricing-mcp AGENTS.md

AGENTS.md instructions for felix-windsor/hermes-procurement-pricing-mcp, a project described as: Secure procurement quotation comparison MCP service with document parsing, mock market pricing, anomaly detection, and Telegram/Hermes integration.

felix-windsor/hermes-procurement-pricing-mcp · 174 tokens