/Brain
← Back to catalog
qmd-search

qmd-search

Set up and use qmd for semantic search over the user's /Brain. Use when user says 'set up qmd', 'install semantic search', 'reindex my brain', 'qmd search', or 'why is search falling back to grep'. NOT for: general file search outside /Brain, vector database setup, or debugging unrelated shell issues.

Recommended for: Builder, Explorer, Writer, Strategist, Researcher, Generalist
Claude Code
Install

Copy to ~/.claude/skills/qmd-search.md — copy the skill content below and save it.

Setup
```bash
npm install -g buildyourbrain
byb init
bun install -g @tobilu/qmd
```
Workflow
```bash
byb config
byb reindex
byb search "query"
qmd status
qmd query "query" -c brain --limit 5
```

- Resolve the Brain path from `byb config` before troubleshooting search.
- Prefer `byb reindex` over raw `qmd update` because it already runs in the configured Brain directory.
- If `qmd` is missing, `byb search` falls back to grep. Treat that as degraded mode, not success.

See [references/setup.md](references/setup.md) for install, validation, and failure-mode guidance.
Validation
```bash
byb status
qmd status
byb search "memory"
```
References
Codex
Install

Copy to ~/.codex/skills/qmd-search.md — copy the skill content below and save it.

Setup
```bash
npm install -g buildyourbrain
byb init
bun install -g @tobilu/qmd
```
Workflow
```bash
byb config
byb reindex
byb search "query"
qmd status
qmd query "query" -c brain --limit 5
```

- Resolve the Brain path from `byb config` before troubleshooting search.
- Prefer `byb reindex` over raw `qmd update`.
- If `qmd` is missing, `byb search` falls back to grep. That means semantic search is not actually configured yet.

See [references/setup.md](references/setup.md) for the detailed setup and failure checks.
Validation
```bash
byb status
qmd status
byb search "memory"
```
References
OpenClaw
Install

Included in the OpenClaw bootstrap prompt below.

Setup
```bash
npm install -g buildyourbrain
byb init
bun install -g @tobilu/qmd
```
Workflow
```bash
byb config
byb reindex
byb search "query"
qmd status
qmd query "query" -c brain --limit 5
```

- Resolve the Brain path from `byb config` before troubleshooting.
- Prefer `byb reindex` over raw `qmd update`.
- If `qmd` is missing, `byb search` falls back to grep. That is degraded mode.

See [references/setup.md](references/setup.md) for the detailed setup and failure checks.
Validation
```bash
byb status
qmd status
byb search "memory"
```
References