Summary
Personal and Code Brain wikis are markdown trees agents navigate with generic filesystem tools (ls / grep / read_file). That works, but chat runs often take extra exploratory hops (e.g. root ls, multiple greps, subdirectory ls) before reading the right pages. Humans also have no way to search the wiki without starting an agent.
The OpenWiki Brains launch post called out better retrieval as next work (full-text search / MCP / semantic search).
Proposal (MVP)
searchWiki() over markdown under the wiki root (personal ~/.openwiki/wiki, code ./openwiki)- CLI:
openwiki personal search <query> / openwiki search [--mode personal|code]
- Agent tool:
openwiki_search_wiki returning ranked path / virtualPath / line / snippet
- Prompt nudge: prefer search before broad wiki
ls/grep crawls
Out of scope for the MVP: embeddings, standalone MCP server, FTS index (follow-up when wikis get large).
Relation to #529
Draft retrieval work in #529 appears scoped toward richer code-repo / MCP retrieval. This issue is a smaller Personal/Code Brain keyword-search surface (CLI + agent tool) that can land independently; indexing/rg can come later.
Implementation
I have a PR ready implementing this MVP.
Summary
Personal and Code Brain wikis are markdown trees agents navigate with generic filesystem tools (
ls/grep/read_file). That works, but chat runs often take extra exploratory hops (e.g. rootls, multiple greps, subdirectoryls) before reading the right pages. Humans also have no way to search the wiki without starting an agent.The OpenWiki Brains launch post called out better retrieval as next work (full-text search / MCP / semantic search).
Proposal (MVP)
searchWiki()over markdown under the wiki root (personal~/.openwiki/wiki, code./openwiki)openwiki personal search <query>/openwiki search [--mode personal|code]openwiki_search_wikireturning rankedpath/virtualPath/line/snippetls/grepcrawlsOut of scope for the MVP: embeddings, standalone MCP server, FTS index (follow-up when wikis get large).
Relation to #529
Draft retrieval work in #529 appears scoped toward richer code-repo / MCP retrieval. This issue is a smaller Personal/Code Brain keyword-search surface (CLI + agent tool) that can land independently; indexing/
rgcan come later.Implementation
I have a PR ready implementing this MVP.