用途：osgrep 是自然语言语义代码搜索工具，按概念而非关键字匹配查找代码；精确标识符或字符串搜索仍建议用 grep/rg。
主要能力：基础搜索 osgrep "查询"，可用 search 子命令限定路径；-m 控制结果数（默认10），--per-file 控制每文件匹配数（默认1），--compact/--content/--scores/--plain 控制输出。索引管理：osgrep index（增量）、-r/--reset（重建）、-p 指定目录、-d 预览。高级命令：skeleton 把文件压缩为函数/类签名（约85% token 缩减）；trace 显示符号调用图；symbols 列出索引符号；list 列出已索引仓库；doctor 检查健康；setup 预下载模型（约150MB）；serve 运行后台守护进程（默认端口4444，可用 -p 或 OSGREP_PORT 修改）。集成：osgrep install-claude-code、osgrep install-opencode。
使用方式：需先 cd 进入项目目录（每项目独立 .osgrep/ 索引），再执行 osgrep "查询"；首次搜索较慢，可用 osgrep setup 预下载模型；索引过期可运行 osgrep index 或 --reset。
限制：100% 本地运行，使用 transformers.js 嵌入，无远程 API；索引位于项目根 .osgrep/；首次模型下载约150MB；Teil 结果中 ... 表示截断，需用 Read 读取完整上下文；架构级问题不宜仅依赖片段，应结合读取关键文件。其他未提供细节暂未提供。