bible-cli

Fast, playful Bible CLI (KJV MVP). Built in Rust.

Quick start

cargo build
./target/debug/bible cache --preload
./target/debug/bible read John 3 16
./target/debug/bible today
./target/debug/bible mood peace

Install

cargo install bible-cli

Commands

• bible read <book> [chapter] [verse]
• bible search <query> [--book <book>] [--limit N]
• bible today
• bible random
• bible echo <book> <chapter> <verse> [--window N]
• bible mood <mood> or bible mood --list
• bible cache [--preload] [--source <url-or-path>]

Cache

Defaults to ~/.bible-cli. Override with --data-dir <dir>.

The default KJV source URL is:

https://raw.githubusercontent.com/thiagobodruk/bible/master/json/en_kjv.json

You can pass a local path or your own JSONL via --source.

Color output

By default, colors are enabled only when stdout is a TTY. You can override with:

• --color auto (default)
• --color always
• --color never

Data format

Cached verses are stored as JSONL:

{"book":"Genesis","chapter":1,"verse":1,"text":"In the beginning God created the heaven and the earth."}