2026-10-12 15:51:39 +02:00
|
|
|
# Searchi CLI
|
|
|
|
|
|
|
|
|
|
The CLI is a thin adapter over `searchi-core`; it performs no network requests or
|
|
|
|
|
GPU setup. Index only folders you explicitly choose.
|
|
|
|
|
|
|
|
|
|
```powershell
|
|
|
|
|
cargo run -p searchi-cli -- index --db ./searchi.db --root ./documents
|
|
|
|
|
cargo run -p searchi-cli -- search --db ./searchi.db "termination clause" --limit 10
|
|
|
|
|
cargo run -p searchi-cli -- search --db ./searchi.db "invoice" --json
|
2026-10-12 16:07:53 +02:00
|
|
|
cargo run -p searchi-cli -- search --db ./searchi.db "invoice" --extension pdf --min-size 1024 --json
|
|
|
|
|
cargo run -p searchi-cli -- index --db ./searchi.db --root ./documents --exclude private
|
2026-10-12 15:51:39 +02:00
|
|
|
cargo run -p searchi-cli -- stats --db ./searchi.db --json
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The same arguments work on Linux and macOS. After building, invoke the `searchi`
|
|
|
|
|
binary directly instead of `cargo run -p searchi-cli --`.
|
|
|
|
|
|
|
|
|
|
`index` creates the database if needed; its parent directory must already exist.
|
|
|
|
|
`search` and `stats` require an existing database so a mistyped path does not
|
|
|
|
|
silently create an empty index. Failures exit with a nonzero status and include
|
|
|
|
|
the affected folder or database path. Result limits must be between 1 and 1000.
|
|
|
|
|
|
|
|
|
|
`search --json` emits an array of engine results, including the path, filename,
|
|
|
|
|
snippet, ranking score, and match kind. An empty search emits `[]`. `stats --json`
|
|
|
|
|
emits an object with `files` and `content_files`. JSON is the scripting interface;
|
|
|
|
|
the human-readable output may change as preview support develops.
|
|
|
|
|
|
2026-10-12 16:07:53 +02:00
|
|
|
The CLI searches filenames, bounded text, PDF text and DOCX paragraphs. Results
|
|
|
|
|
include actual matching source locations when available and extraction errors
|
|
|
|
|
for documents that could not be read. Semantic inference and media formats
|
|
|
|
|
remain tracked in the roadmap; this interface does not fabricate embeddings.
|
|
|
|
|
|
|
|
|
|
Filters apply before result limits: `--folder`, `--extension`, `--min-size`,
|
|
|
|
|
`--max-size`, `--modified-after-ms`, and `--modified-before-ms`. Dates are Unix
|
|
|
|
|
milliseconds and inclusive. Repeated `index --exclude NAME` flags add directory
|
|
|
|
|
names to the defaults (`.git`, `node_modules`, `target`).
|
