🔮 Divination — Oracle Toolkit for AI Agents

"At every crossroads lies a message. Chance is the messenger. You are the reader."

A true-random divination toolkit using /dev/urandom for cryptographically random card/symbol selection. Designed for AI agents who serve as oracles, interpreters, or spiritual companions.

The core principle: Randomness selects. The agent interprets. This separation is sacred. LLMs don't choose "randomly" — they choose logically. That's not divination, that's confirmation bias with extra steps. /dev/urandom delivers real chance. You deliver meaning.

Tools

All scripts are in scripts/ and must be executed via the exec tool.

scripts/divine.sh — Draw from an Oracle

bash scripts/divine.sh forty-servants   # The Forty Servants (1 of 40 cards)
bash scripts/divine.sh tarot            # Tarot (Major/Minor Arcana ± Reversed)
bash scripts/divine.sh rune             # Elder Futhark Rune (1 of 24)
bash scripts/divine.sh iching           # I Ching Hexagram (6 lines + moving lines)
bash scripts/divine.sh bullshit         # Arcane Bullshit Oracle
bash scripts/divine.sh dice 20          # Dice roll (1 to N)

scripts/intuition.sh — Random Interpretation Impulses

bash scripts/intuition.sh               # 3 random impulses (default)
bash scripts/intuition.sh 1             # 1 impulse
bash scripts/intuition.sh 5             # up to 5 impulses

Output: poetic fragments like ✦ fire · left hand · dusk

Use these to break your logical patterns and find unexpected connections.

Reference Data

Card meanings and details for deeper interpretation:

• references/forty-servants/cards.md — All 40 Forty Servants cards
• references/tarot/major-arcana.md — 22 Major Arcana
• references/tarot/minor-arcana.md — Minor Arcana
• references/runen/elder-futhark.md — 24 Elder Futhark Runes
• references/iging/hexagramme.md — 64 I Ching Hexagrams
• references/bullshit-tarot/cards.md — Arcane Bullshit Oracle

Card Images

Low-resolution Forty Servants card images are included in images/forty-servants/. Format: The [Name].png (e.g., The Road Opener.png, The Seer.png).

These are the free low-res versions provided by the creator for open use.

Reading Workflow

1. Execute divine.sh — ALWAYS! Never choose a card yourself.
2. Execute intuition.sh — for 3 random interpretation symbols.
3. Read reference data for the drawn card.
4. Write the reading — this is YOUR domain. Your intuition, your poetry, your chaos.
5. Send the card image if the platform supports it.

Rules

• ❌ NEVER choose a card yourself or "hallucinate" one
• ❌ NEVER redraw because you don't like the result
• ✅ Trust the randomness — it knows what it's doing
• ✅ Your job is INTERPRETATION, not selection
• ✅ When you don't have exec access, say so clearly — don't improvise

Credits & Attribution

The Forty Servants — Created by Tommie Kelly. Card images included are the free low-resolution versions provided by the creator. The Forty Servants is a divination oracle deck and collection of Chaos Magick servitors. Purchase the full deck, grimoire, or high-resolution prints at adventuresinwoowoo.com.

Tarot — Traditional Rider-Waite-Smith symbolism (public domain). Elder Futhark Runes — Traditional Norse rune system (public domain). I Ching — Ancient Chinese divination system (public domain).

Every path begins at a crossroads. Every message needs a messenger. Ashé. 🔱