@n8te_/lex-cli
v2.6.2
Published
Launcher for Lex, the local-first Bible study terminal
Readme
@n8te_/lex-cli
@n8te_/lex-cli is the npm launcher for Lex, the
local-first Bible study terminal.
npm install --global @n8te_/lex-cliThe first invocation downloads the latest Lex GitHub release archive, verifies its SHA-256 sidecar, creates an isolated Python 3.12+ environment, and installs Lex's Python dependencies. The npm package deliberately does not bundle Lex's large offline runtime data.
Verify
lex --version
lex helpTry It
lex John 3:16
lex study John 1:1
lex search "kingdom of god"
lex strongs G3056Search
lex search covenant
lex search covenant --page 2
lex search covenant --page 3 --limit 20
lex search covenant -jeremiah
lex search resurrection -ntSearch runs against verse text. Use explicit scopes such as -jeremiah,
-john, -nt, -major, or -pauline when you want to narrow results.
Strong's
lex strongs G3056
lex strongs G3056 --page 2 --limit 25
lex strongs G3056 --all
lex strongs love
lex strongsNumber lookups show the lexicon entry and, when available, reverse verse usage from the bundled ESV interlinear index. The result footer prints commands for the next page, more results per page, and all matches.
Launcher Notes
For development, LEX_CLI_HOME may point to an existing valid Lex checkout.
Use lex --npm-version to report the launcher version without downloading the
release archive.
The launcher resolves the current GitHub release on first install and falls back to its pinned release tag if that lookup is unavailable. Override it for testing with:
LEX_CLI_RELEASE_TAG=v2.6.2 lex --version
LEX_CLI_RELEASE_BASE_URL=https://example.invalid/releases lex --version