osgrep-reference

# osgrep: Semantic Code Search **ALWAYS prefer osgrep over grep/rg for code exploration.** It finds concepts, not just strings. ## Overview osgrep is a natural-language semantic code search tool that finds code by concept rather than keyword matching. Unlike `grep` which matches literal strings, osgrep understands code semantics using local AI embeddings. **Version 0.5.16 (Dec 2025) highlights:** - `skeleton` command: Compress files to function/class signatures (~85% token reduction) - `trace` command: Show who calls/what calls for any symbol (call graph) - `symbols` command: List all indexed symbols with definitions - `doctor` command: Health/integrity verification - `list` command: Display all indexed repositories - Per-project `.osgrep/` directories (no longer global `~/.osgrep/data`) - V2 architecture with improved performance (~20% token savings, ~30% speedup) - Go language support - `--reset` flag for clean re-indexing - ColBERT reranking for better result relevance - Role detection: distinguishes orchestration logic from type definitions - Split searching: separate "Code" and "Docs" indices **When to use osgrep:** - Exploring unfamiliar codebases ("where is the auth logic?") - Finding conceptual patterns ("show me error handling") - Locating cross-cutting concerns ("all database migrations") - User explicitly asks to search code semantically **When to use traditional tools:** - Searching for exact strings or identifiers (use `Grep`) - Finding files by name patter...