Troubleshooting#
AI Generated, Human Reviewed at: 2026-11-16T20:08:02Z
Searching#
passagessaysgap: truefor something you know is there. It matches by words and has no stemming, so "rolling" does not match "roll". Try the file's own words.kb search rollmatches by substring, so it findsrollback, and semantic search (semantic: true) matches by meaning. Getting started covers all three.- A search from the wrong folder finds nothing, and says only
gap: true. Bowerbird looks for akbmcp.yamlin the current folder and then in the folders above it, never below. From a folder that is not a collection, or from the parent of several, there is nothing to search. Run it inside the collection, or name the file:kb --config path/to/kbmcp.yaml passages .... - A hit says
stale. The file changed after its review. Read it again and seal it again.
Settings#
init holds=adrdid not change the format.holdsonly applies when there is nokbmcp.yamlyet. On an existing collection, edit theformat:line inkbmcp.yamland runkb reindex.seal-only needs seal.require. In aseal-onlycollection the policy must name the files that need a review:seal: {require: ["src/**/*.py"]}inkbmcp.yaml.- My MCP server does not offer
seal. Ifroles:inkbmcp.yamlspells the roles out,sealhas to be in the list. A file with noroles:line gets all five. Asking for a role that is left out (--role seal) refuses to start, with "role seal is off in kbmcp.yaml". KB_ROOT is no longer read. The old environment variable is gone. Put the folder'skbmcp.yamlwhere the tool runs, or name it with--config.
Installing#
rdflib is missing(askoscollection). Install the extra:pip install rdflib, or withuvx, ask for it:uvx --from "bowerbird-mcp[skos]" bowerbird-mcp.- Semantic search does not start with the bare script.
uvx bowerbird-mcpcarriesfastembed; the one-file script needsuv run --with fastembed bowerbird_mcp.py. uvxruns an old build while you test local changes. Add--no-cache.