warp-grep 是运行在代码库上的语义搜索工具，底层由 MorphLLM 的 warpgrep 提供，是一个经强化学习训练的子代理，会自行规划并执行约 15-30 次内部 grep 与读取操作，来回答关于代码的自然语言问题。与普通 grep 不同，它理解查询意图并追踪跨文件的数据流。使用前需要设置 MORPH_API_KEY 环境变量。
适用场景：理解某个功能如何跨多个文件协作（如“认证中间件如何校验令牌？”）；端到端追踪数据流（如“用户点击结账后发生了什么？”）；探索不熟悉、不知道用什么关键词搜索的代码库；回答架构性问题（如“数据库层是如何组织的？”）；调试跨文件、关联不明显的交互。
不适用场景：简单关键词或符号查找（如查找 handleSubmit 的所有使用）应使用 Grep；按文件名或模式查找文件应使用 Glob；查询库文档应使用 context7；与当前代码库无关的问题也不适用。
判断规则：如果你能自己写出 grep 模式，用 Grep 更快；如果问题偏概念性、写不出模式，就用 warp-grep。
基本用法：运行 python3 scripts/warp-grep.py search "<自然语言查询>" [repo_path]。query 是关于代码的自然语言问题，repo_path 是仓库根路径，默认当前目录。示例：python3 scripts/warp-grep.py search "how does the authentication flow work"；python3 scripts/warp-grep.py search "how are database migrations handled" /path/to/repo；加 --search-type node_modules 可搜索 node_modules；加大型代码库超时可用 --timeout 180。完整用法见 python3 scripts/warp-grep.py --help。注意不要阅读脚本源码，直接运行脚本并用 --help 查看用法。
使用规则：查询尽量写成自然语言问题，例如“How does the auth middleware validate JWT tokens?”比“auth JWT”效果好，因为 warpgrep 会根据问题自行规划搜索策略；描述得越具体、上下文越多，内部搜索定位越准；它用于“理解”而非“查找”，已知符号或关键词时 Grep 更快。默认超时为 120 秒，大型代码库建议用 --timeout 180 或更高。收费标准、平台支持范围等资料暂未提供。