# llmgrep
llmgrep is a smart grep CLI built to be used with Magellan (code map + SQLite) and emits schema-aligned JSON for LLM workflows.
Magellan repository: https://github.com/oldnordic/magellan
Compatibility:
- Magellan schema version: 1.0.0 (JsonResponse wrapper)
- Magellan export version: 2.0.0
- Minimum Magellan version: 1.7.0
## What it does
- Searches symbols, references, and calls from Magellan's database
- Emits deterministic, schema-aligned JSON output
- Supports regex, ranking, stable IDs, and optional context/snippets
## Install
```
cargo build --release
cp target/release/llmgrep /home/feanor/.local/bin/llmgrep
```
## Quick start
1) Build a database with Magellan:
```
magellan watch --root /path/to/repo --db /tmp/repo.db
```
2) Query it with llmgrep:
```
llmgrep search --db /tmp/repo.db --query "parse" --output json
```
## Docs
- `docs/USAGE.md`
- `docs/CLI_PATTERNS.md`
- `docs/JSON_EXPORT_FORMAT.md`
- `docs/SCHEMA_REFERENCE.md`
## Tested scope
Verified locally on this repo:
- Magellan indexing to `/tmp/llmgrep.db`
- `llmgrep search` in `symbols`, `references`, `calls`, and `auto` modes
- JSON output with context/snippet/score flags
## License
GPL-3.0-only. See `LICENSE.md`.