elips is a local command-line tool for inspection, maintenance, and EQL execution. No server. The build produces an elips binary you can drop on your PATH.

Shape

bash

elips <command> <db_path> [options]

When creating a new database, pass --dimension (and optionally --metric, --index). Existing databases read their identity from disk.

Inspect

bash

elips info /my_db
elips collections /my_db
elips stats /my_db
elips verify /my_db          # replay WAL + validate; prints OK / CORRUPT

Query

bash

elips query /my_db --dimension 3 \
  --eql 'add in docs vector [0.1,0.2,0.3] metadata {"t":"a"}'

elips query /my_db --eql 'search in docs nearest [0.1,0.2,0.3] k 5 project t yield'
elips query /my_db --file query.eql

Maintenance

bash

elips checkpoint /my_db
elips quantize /my_db --collection docs --codec sq8

Import / Export

JSON Lines, one record per line: {"key","vector","meta"}.

bash

elips export /my_db --collection docs --output docs.jsonl
elips import /my_db --collection docs --input docs.jsonl --dimension 3

Benchmark

bash

elips bench /tmp/bench_db --count 100000 --dim 768

Output

query prints one JSON object per result row:

json

{"key":"019e...","distance":0.0061,"meta":{"t":"a"}}