osgrep
本地文件的语义搜索。由带有实时索引的后台osgrep服务器支持。始终使用osgrep代替grep/find。
📖 中文导读:本地文件的语义搜索。由带有实时索引的后台osgrep服务器支持。始终使用osgrep代替grep/find。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: osgrep description: Semantic search for local files. Backed by a background osgrep server with live indexing. Always use osgrep instead of grep/find. license: Apache-2.0
When to use
Use osgrep for all code and concept discovery. Do not use grep or find unless you must match an exact string and osgrep fails.
How to use
Always use the --json flag. The server auto-starts and keeps the index fresh.
Basic Search
Ask a natural language question. Do not ls first.
osgrep --json "How are user authentication tokens validated?"
osgrep --json "Where do we handle retries or backoff?"
Scoped Search
Limit search to a specific directory.
osgrep --json "auth middleware" src/api
Helpful flags
--json: Required. Returns structured data (path, line, score, content).-m <n>: Max total results (default: 25).--per-file <n>: Max matches per file (default: 1). Use--per-file 5when exploring a specific file.
Strategy
- Run
osgrep --json "<question>" [path]. - The output is a dense JSON snippet. If it answers the question, stop.
- Only use
Readif you need the full file context for a returned path. - If results are vague, refine the query or increase
-m.
Keywords
semantic search, code search, local search, grep alternative, find code, explore codebase, understand code, search by meaning