Fate Shuffle

Cryptographic tarot with intention-aware timing.

Fate Shuffle is a local Python tarot skill that blends operating-system cryptographic randomness with the user's question, an auto-generated focus, the draw confirmation token, the spread, and the UTC draw time. It supports upright and reversed cards, bilingual card data, Chinese-first text output, English output, and JSON audit fields.

Features

• 78-card Rider-Waite-Smith style tarot deck
• Upright and reversed card orientations
• OS cryptographic randomness via Python secrets.token_bytes(32)
• BLAKE2b entropy mixing from question, focus, draw token, spread, and time
• Chinese default output with optional English output
• JSON output with audit fields and full bilingual card metadata
• No external Python dependencies

Quick Start

python3 scripts/draw_tarot.py \
  --spread 3-card \
  --question "Will I change jobs in the next three months?" \
  --draw-token "draw" \
  --language en

Chinese output is the default:

python3 scripts/draw_tarot.py \
  --spread 3-card \
  --question "未来三个月感情上有没有缘分？" \
  --draw-token "抽"

Use JSON when you want the audit trail:

python3 scripts/draw_tarot.py \
  --spread 4-card \
  --question "Career direction" \
  --draw-token "draw" \
  --json

Spreads

• single: one card
• 3-card: past / present / future
• 4-card: situation / obstacle / advice / outcome
• relationship: you / the other / connection / challenge / strength / potential
• decision: situation / option A / option B / what to know / advice
• custom: use --count N

Verify

python3 scripts/test_draw_tarot.py

Skill Install

To use this as a Codex skill, copy this folder into your Codex skills directory:

cp -R . ~/.codex/skills/fate-shuffle

Then restart Codex.

Notes

Fate Shuffle provides a symbolic and technical influence model, not scientific proof of metaphysical causation. In software terms, the draw is backed by OS cryptographic randomness, and the user's question, focus, confirmation token, spread, and timing are part of the hashed seed material.