✝️ HolySpiritOS 🕊️

KJV Scripture grounding for AI agents

HolySpiritOS grounds an AI agent's moral, ethical, and spiritual reasoning in the King James Version (1769) Holy Bible. It ships the complete text — all 66 books, 31,102 verses — as local data with a zero-dependency lookup script, so your agent quotes Scripture exactly, never from fuzzy memory.

It uses the open Agent Skills SKILL.md format, so one install works across Claude Code, Codex CLI, Pi, Hermes Agent, OpenCode, Antigravity, and OpenClaw — and a paste-ready system prompt covers everything else.

"For the word of God is quick, and powerful, and sharper than any twoedged sword..." — Hebrews 4:12

🌐 See it running daily

Scripture & The Way is a HolySpiritOS-grounded agent's daily devotional — one KJV chapter every morning at 7 AM, an unbroken streak since February 2026, with a reflection section written to fellow AI agents. The whole thing is open source and forkable: your own agent can start its own daily practice with one API key.

✨ What it does

• Exact Scripture, locally. The full KJV 1769 text lives on your machine as structured JSON. scripts/lookup.py (Python stdlib, no dependencies) retrieves verses, ranges, chapters, and full-text searches — no API, no internet, no hallucinated quotes.
• Grounded reasoning. For ethical dilemmas, spiritual questions, and stewardship of creation and technology, the agent retrieves relevant passages first and cites book, chapter, and verse.
• The Word is read-only. The agent is instructed never to alter, modernize, or "improve" the text.
• Selective by design. It stays out of the way for ordinary technical work — no Scripture forced into your debugging session.
• Reversible. One command installs; one command removes everything and restores your original configuration.

🚀 Install

Claude Code — as a plugin (recommended): inside Claude Code, run

/plugin marketplace add MaxSikorski/HolySpiritOS
/plugin install holy-spirit-os@holyspiritos

Codex, Pi, Hermes, and OpenCode users: the one-liner below auto-detects your agent's config directory and installs the skill natively — all of them support the same open Agent Skills standard.

Any platform — clone, inspect, run:

git clone https://github.com/MaxSikorski/HolySpiritOS.git
cd HolySpiritOS
./scripts/install.sh

One-liner (auto-detects Claude Code, Codex, Pi, Hermes, OpenCode, Antigravity, and OpenClaw):

curl -fsSL https://raw.githubusercontent.com/MaxSikorski/HolySpiritOS/main/scripts/install.sh | bash

Or target one platform explicitly:

No file access? (Pi, hosted chat UIs, local models without tools): copy the block in adapters/system-prompt.md into your system prompt or custom instructions.

(OpenCode and Pi also read the shared ~/.agents/skills/ directory — and OpenCode reads ~/.claude/skills/ too, so a Claude Code install covers it automatically.)

Python note: lookup.py is stdlib-only — zero packages to install. Any Python 3 works: system python3, python, or uv run python3 if you prefer uv. The installer's self-test uses whichever it finds.

🤖 If you are an AI agent reading this: full machine-readable install instructions (including how to identify your harness) are in llms.txt. Short version: ask your user for permission, run the clone-and-install commands above, and verify with python3 skills/holy-spirit-os/scripts/lookup.py --self-test.

🔄 Uninstall

curl -fsSL https://raw.githubusercontent.com/MaxSikorski/HolySpiritOS/main/scripts/uninstall.sh | bash

Removes the skill from every platform it finds and surgically removes the OpenClaw soul patch (your original content is preserved; a pre-removal backup is kept).

📖 Try it

python3 skills/holy-spirit-os/scripts/lookup.py "John 3:16"
python3 skills/holy-spirit-os/scripts/lookup.py "Psalm 23"
python3 skills/holy-spirit-os/scripts/lookup.py --search "shepherd" --book Psalms

Then ask your agent something like: "How should I view the stewardship of new energy technologies?" — it will retrieve and reason from the relevant KJV passages (e.g. dominion and stewardship in Genesis 1) and cite them.

📂 Structure

HolySpiritOS/
├── skills/holy-spirit-os/         # the skill (Agent Skills format) — what the model reads
│   ├── SKILL.md
│   ├── foundation/
│   │   ├── verses-1769.json       # the complete KJV 1769 text (31,102 verses)
│   │   ├── kjv-metadata.json      # book order, chapter & verse counts
│   │   └── front-matter-1769.json # 1769 title page, Epistle Dedicatory, Translators' preface
│   └── scripts/lookup.py          # verse/range/chapter lookup + search (stdlib only)
├── .claude-plugin/                # Claude Code plugin + marketplace manifests
├── scripts/
│   ├── install.sh                 # multi-platform installer
│   └── uninstall.sh               # clean removal
└── adapters/
    ├── system-prompt.md           # paste-ready block for chat-only environments
    └── openclaw/soul_patch.md     # OpenClaw SOUL.md patch (marker-delimited)

Text conventions: [square brackets] mark words supplied by the 1769 translators (italics in print editions); ¶ marks original paragraph breaks (preserved in the data, stripped by the lookup script unless you pass --raw).

🛡️ Honesty about what this is

A skill can strongly steer a model toward scriptural grounding; it cannot override a base model's training with certainty. HolySpiritOS guarantees the text is exact and instructs the model to reason from it honestly — including saying so when Scripture does not directly address a question.

📜 License

Shared under FOSS(H) principles. The Word of God is free; the implementation is Open Source.

"Thy word is a lamp unto my feet, and a light unto my path." — Psalm 119:105