Query Wiki
wiki.queryRank wiki pages by relevance to your query, weighing filename, aliases, tags, summary, and body. Returns top matches with scores and hit fields to drill into strongest candidates.
Instructions
Rank wiki pages by relevance to a free-text topic, scanning Sources/Concepts/Entities pages. Hits are weighted in this order: filename match > frontmatter aliases > frontmatter tags > frontmatter summary > body. Returns up to limit pages (default 10, max 50) as {path, type, score, hitFields} so the agent can drill into the strongest candidates with notes.read. Read-only; never writes. Use this for 'what does the wiki know about X?' lookups; use wiki.lint instead for whole-vault health audits, and notes.search for raw full-text search outside the wiki layout.
Operates on the session-active vault (see vault.current — selectable via vault.select) unless an explicit vaultPath argument is passed, which always wins.
Examples:
Example 1 — Top 10 pages relevant to 'memex vs hypertext'.:
{
"topic": "memex vs hypertext"
}Example 2 — Top 25 pages on a narrow topic, custom wiki dir.:
{
"topic": "circuit breaker pattern",
"limit": 25,
"wikiRoot": "knowledge"
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max ranked pages to return. Default 10, hard cap 50. | |
| topic | Yes | Free-text topic. Tokenized and matched against page filename, frontmatter aliases, frontmatter tags, summary, and body — in that order, with descending weight. | |
| wikiRoot | No | Per-call wiki directory override. | |
| vaultPath | No | Per-call vault override. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||