bible-study-cli

Bible Study CLI

Powered by Kontyra

An elegant, offline-ready, and highly interactive Command Line Interface (CLI) Bible Study toolkit built from scratch. Designed with professional terminal aesthetics matching the Kontyra developer toolchain.

⚡ Features

• 100% Offline-Bundled Database: Includes the complete King James Version (KJV) database (all 66 books, 1,189 chapters, and 31,102 verses) built-in with zero first-run network delay.
• Stunning Terminal UI (TUI): Beautiful autocomplete menus to browse books and chapters, custom double-bordered text frames, and paging shortcuts (➡️ Next Chapter / ⬅️ Prev Chapter) to read consecutively across the entire Bible.
• Flexible Reference Parser: Intelligent input mapper translating over 100+ book abbreviations (like Jn, 1Cor, Gen, 1 Kings) into exact passage references.
• Full-Text Search Engine: Instant keyword and phrase query scanner highlighting hits on a high-legibility deep Teal terminal background.
• Companion Developer Commands: System integrity diagnostics (doctor), version mapping (info), quickstart tutorials (guide), and inspirational quotes (random).
• High Performance: Minimal memory footprint, sub-30ms startup speeds, and zero third-party telemetry.

📦 Install

Install the CLI toolkit globally using npm:

npm install -g bible-study-cli

CLI alias: bible.

🚀 Quickstart & Commands

Launch the primary interactive browsing and study loop using:

bible

Direct Passage Lookups

Read any specific chapter, verse, or verse range immediately:

# Read an entire chapter
bible read "Psalm 23"
bible read "Gen 1"
bible read "1Cor 13"

# Read a specific verse
bible read "John 3:16"

# Read a range of verses
bible read "Jn 3:16-18"

Full-Text Scripture Search

Find single terms or exact phrase matches across both testaments:

# Word search
bible search faith

# Exact phrase search
bible search "for God so loved"

Grid Book Listing

Show a grid-layout of all 66 books grouped by Old and New Testament, showing aliases and chapter counts:

bible books

Diagnostics & Developer Helpers

Verify database files, check versions, and query resources:

# Run system and database diagnostic checks
bible doctor

# Display detailed package, runtime, and database metadata
bible info

# Read a quickstart manual directly in the terminal
bible guide

# Display a beautifully framed random inspiring verse
bible random

🛠️ Development & Compilation

To build and compile the source files locally:

# Install dependencies
npm ci

# Compile TypeScript to dist/ JS files
npm run build

# Run local binary tests
node bin/index.js doctor

🤝 Contributing

We welcome open-source contributions. Please read CONTRIBUTING.md and RELEASE.md to understand our development, branching, and releasing workflows.

📄 License

This project is proprietary and confidential. Licensed under a Proprietary Agreement - see the LICENSE file for details.

(c) 2026 Kontyra. All Rights Reserved.