在一个堆满代码和文档的工作区里，人常记得关键词，AI Agent却更需要按“意思”寻找线索。zvec-grep（命令名为 zg）想让两者共用同一套本地搜索入口：安装、建立一次索引后，开发者可在终端查询，Agent也能从同一工作区提取完成任务所需的上下文。文件、索引和本地模型默认留在用户设备上；只有用户允许时，数据才会发送给远程 embedding（把文本转换成语义数字表示的服务）。
它把三种检索方式合在一起：ripgrep负责快速查文本，BM25按关键词相关性排序，向量搜索则寻找意思相近、但用词不同的内容。找到候选片段后，还能用原文或正则表达式——描述文本模式的规则——进一步核对。项目演示中，用户用自然语言询问侦探如何从神秘动物留下的痕迹作出推断，zg把《福尔摩斯回忆录》的相关段落排在《爱丽丝梦游仙境》之前，并保留文件位置供引用。值得关注的不是又多了一种搜索算法，而是它试图把“人找文件”和“Agent取上下文”收进同一条本地工作流；不过现有材料主要是项目方介绍与演示，尚不足以判断它在真实大型工作区中的效果。该工具目前要求 Node.js 22 或更新版本。