osgrep

pr-pm 的头像作者 pr-pm

本地文件的语义搜索。由带有实时索引的后台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.

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?"

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 5 when exploring a specific file.

Strategy

  1. Run osgrep --json "<question>" [path].
  2. The output is a dense JSON snippet. If it answers the question, stop.
  3. Only use Read if you need the full file context for a returned path.
  4. 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