Divination

# 🔮 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
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
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

##...