Context Search (QMD)

Context Search (QMD)

Search past Claude Code sessions and knowledge bases using QMD.

Automatic Context

The UserPromptSubmit hook automatically injects relevant past context on every user message. You don't need to call this manually for user prompts — it's already happening.

On-Demand Search (for agents and tools)

When you or a subagent needs to search past sessions or knowledge bases explicitly — for example, to check if a topic was previously discussed, to find a past decision, or to get context for a task — use:

uv run ${CLAUDE_PLUGIN_ROOT}/skills/context-search/scripts/search-tool.py "your search query"

Options:

• --cwd /path — search from a specific project root (defaults to current directory)
• --debug — show timing and collection info on stderr
• --no-reindex — skip the index freshness check (faster)

The tool reads search-config.yaml from the working directory, searches all configured collections, and prints formatted results with file paths and line numbers.

Preferred: Use search-tool.py

Always prefer search-tool.py over calling qmd directly. The tool handles config resolution, collection flags, path resolution, and output formatting.

If you must call QMD directly, the JSON output fields are:

• file — QMD URI (e.g., qmd://collection-name/file.md), NOT path
• title — document title
• score — relevance score
• snippet — text excerpt with @@ -LINE,COUNT @@ position markers
• docid — short hash ID
• context — collection description

IMPORTANT: The field is file, not path. There is no path field in QMD output.

When to Use This

• Before proposing solutions to design decisions or architecture choices
• When the user asks "did we discuss..." or "what did we decide about..."
• When you need context about a previous session's outcome
• When a subagent needs background on a topic it wasn't part of

Commands

• /context-search-qmd:setup — Interactive setup
• /context-search-qmd:search — Manual search
• /context-search-qmd:status — Show config and index state
• /context-search-qmd:collections — List/manage collections
• /context-search-qmd:reindex — Re-index collections