← ClaudeAtlas

osgrep-referencelisted

Comprehensive CLI reference and search strategies for osgrep semantic code search. Use for detailed CLI options, index management commands, search strategy guidance (architectural vs targeted queries), and troubleshooting. Complements the osgrep plugin which handles daemon lifecycle.
tdimino/bg3se-macos · ★ 59 · AI & Automation · score 83
Install: claude install-skill tdimino/bg3se-macos
# 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