Bibe Code CLI

A Bible reading under your coding agent's final answer, once each time it finishes a task — following a reading plan you choose, at your pace. The verses come from the hook, not the model, so they cost no model tokens.

npm install -g bible-coder     # or: pnpm add --global bible-coder
bible-coder setup

Setup picks your Bible (free WEB or KJV, or a Pro translation), sets a reading goal (default: the Gospel of John), and asks before installing hooks into your agents.

Works with

| Agent | Reading under the final answer | MCP tools | | --- | --- | --- | | Claude Code | Yes | Yes | | Codex CLI and Codex app | Yes (Codex CLI asks you to trust the hook once in /hooks) | Yes | | Gemini CLI | Yes (experimental) | Yes | | Grok, OpenHarness | No — Bibe Code stays silent there and never advances your plan | Use bible-coder next |

Hooks never block your prompt. If something goes wrong, the reading is skipped and your agent answers as usual.

Read

bible-coder next              # show your next reading
bible-coder next --record     # show it and mark it read
bible-coder read "Ephesians 6:10-18"
bible-coder forward | random  # five verses on, or one random verse

A reading is marked read only after it is actually shown. Chapters over 30 verses come in parts of at most 20 verses (Psalm 119 is nine readings), so every reading fits a calm moment. When you finish a plan, the next reading suggests what to read next, and then Bibe Code stays quiet (at most one reminder a day).

Keep your plan in your hands

bible-coder goal update --goal "Read Genesis"
bible-coder plans             # list plans (add --all for archived)
bible-coder plan use 2        # choose which plan your agent follows
bible-coder plan pause        # set it aside; resume with: plan resume
bible-coder plan archive      # hide it; bring it back with: plan restore
bible-coder skip              # move on without marking it read
bible-coder undo              # reverse your last read or skip

Plan numbers stay the same as you add plans. Every command takes --json. Your agent can do the same through the MCP tools plan_list, plan_use, plan_pause, plan_resume, plan_archive, plan_restore, plan_skip, plan_undo, plan_record, and plan_attempt. Pause, archive, skip and undo apply to this device; undoing a reading that already synced does not change your other devices.

Upgrading from 0.2.x

Run bible-coder hooks repair --yes once. It moves your hooks from every prompt to the final answer and onto the stable launcher (Codex CLI asks you to trust the new entry once). Until you do, older hooks still work but show at most one reading every 20 minutes, never for background wake-ups.

Keep it working

bible-coder doctor            # dry-runs each installed hook and prints the exact fix if one is broken
bible-coder hooks repair --yes   # puts back hooks another tool removed or broke (backs up first)
bible-coder mute | unmute | stop | start
bible-coder color off         # plain readings (default: red heading, gold reference)

Hooks call a stable launcher that finds bible-coder each time, so switching between npm and pnpm, or upgrading, does not switch the reading off. If the CLI goes missing, you see one repair line instead of an error on every prompt.

Codex CLI: after installing or repairing, type /hooks and trust the Bibe Code entries (they run ~/.local/share/bible-coder/hooks/launch.sh hooks run --client codex ...). Codex asks again only if the hook command changes; package upgrades do not change it. Codex CLI then shows each reading under its final answer, free and Pro translations alike.

Pro

Pro adds more translations, including modern ones like NLT, CSB, and MSG, shown with attribution and saved on your device for up to 14 days within API.Bible's terms, plus Prayer Gate, which holds git push until you type I have prayed.

bible-coder login --email [email protected]   # bought Pro on bibecoder.com? sign in with that email
bible-coder checkout          # start Pro from the terminal
bible-coder bible             # choose your Bible
bible-coder billing portal
bible-coder logout            # sign this device out

Goals and reading plans are free. Bibe Code never sends paid Bible text to an AI model to build plans.

MCP

claude mcp add --scope user bible-coder -- bible-coder-mcp
gemini mcp add --scope user bible-coder bible-coder-mcp

More at bibecoder.com.