llms.txt

# embgrep
> Local semantic search -- embedding-powered grep, zero external services.
`pip install embgrep` | extras: `[cli]` `[mcp]` `[all]`
- Index files by glob into SQLite+fastembed vectors, smart chunking by language
- Semantic search via cosine similarity with path filtering
- Incremental update (SHA-256 hash), MCP server (4 tools, stdio)
## Exports
`EmbGrep` class, `SearchResult`/`IndexStatus` dataclasses, module-level `index`/`search`/`status`/`update`
## Example
```python
from embgrep import EmbGrep
eg = EmbGrep()
eg.index("./docs", patterns=["*.md", "*.py"])
results = eg.search("error handling", top_k=5)  # list[SearchResult]
eg.close()
```
- [Full API](/llms-full.txt)
- [PyPI](https://pypi.org/project/embgrep/)
- [Source](https://github.com/QuartzUnit/embgrep)