osgrep-referencelisted
Install: claude install-skill tdimino/claude-code-minoan
# osgrep: Semantic Code Search
Prefer osgrep over grep/rg for conceptual code exploration—it finds code by meaning, not just string matching. For exact identifier or literal string searches, grep/rg remains appropriate.
## 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