Skip to main content
← CLI Reference

travsr rerank

Manage the cross-encoder model that reorders search results by relevance.

travsr rerank status
travsr rerank install

Subcommands​

CommandWhat it does
installDownload the cross-encoder model into ~/.travsr/models/rerank
statusReport whether the model is installed

What reranking does, and does not do​

The reranker reorders candidates that the graph already produced. It never decides an edge, never adds a result, and never removes one from the graph. Retrieval stays deterministic and structural; the model only changes the order in which already-retrieved candidates are presented.

That boundary is deliberate: an LLM-adjacent component that could determine graph structure would put a probabilistic answer where an exact one belongs.

Optional, and fail-open​

The daemon fetches the model into ~/.travsr/models/rerank on start when it is missing, so most installs never run travsr rerank install by hand. Set TRAVSR_NO_RERANK=1 to disable the reranker entirely, or TRAVSR_NO_RERANK_AUTOFETCH=1 to skip only the automatic download (an installed model still loads). After travsr rerank install, restart the daemon (travsr daemon restart) to activate the model.

A missing or unloadable model degrades to lexical ordering rather than failing the query. travsr status reports the reranker's state alongside the rest of the index.

$ travsr rerank status
reranker model: installed