lorix-cli

lorix-cli is a local-first CLI for indexing Git history and searching it from the terminal.

It currently focuses on a simple, inspectable workflow:

• build a local index for a Git repository
• search commit history by query
• find related commits
• trace file history
• inspect one commit and nearby similar work

Install

npm install -g lorix-cli

If the package is not published yet:

git clone https://github.com/sukumarrekapalli/lorix.git
cd lorix/packages/cli
npm pack
npm install -g ./lorix-cli-0.1.0-alpha.0.tgz

Usage

Move into any Git repository and run:

lorix init
lorix search "authentication middleware"
lorix related <sha>
lorix file src/auth.ts
lorix inspect <sha>
lorix stats
lorix doctor

Lorix stores its local index in:

.lorix/index.json

inside the target repository.

Commands

• lorix init builds a local index
• lorix sync rebuilds the local index
• lorix search "query" searches commit history
• lorix related <sha> finds nearby related commits
• lorix file <path> shows commits that touched a file
• lorix inspect <sha> shows one commit and related context
• lorix stats shows repository and index stats
• lorix doctor checks Git and index availability

Current Scope

• deterministic local token-vector ranking
• no LLM required
• no remote AI provider required
• no cloud service dependency

Limitations

• search quality depends on commit-message quality
• results are lexical, not deep semantic understanding
• diffs and symbols are not parsed yet
• large repositories will eventually need stronger storage than JSON

Repository

• Source: https://github.com/sukumarrekapalli/lorix
• Issues: https://github.com/sukumarrekapalli/lorix/issues

License

MIT