Divination tools for the terminal

Astrology, tarot, gematria, numerology: Thoth CLI

Real ephemeris calculations. Cryptographic randomness for tarot. Classical gematria systems. All from your terminal.

☉ Astrology🂡 Tarotא Gematria∞ Numerology

npm install -g thoth-cli

Tarot uses secrets.SystemRandom for true cryptographic entropy.

Install

npm, pnpm, or bun. Node ≥ 20.

npm install -g thoth-cli

pnpm add -g thoth-cli

bun add -g thoth-cli

npx thoth-cli moon

npx thoth-cli tarot

Real calculations, real randomness.

Natal charts, transits, synastry, returns — powered by Swiss Ephemeris, the gold standard for astrological calculation. Accurate to the arcminute.

Tarot draws use secrets.SystemRandom — true entropy from the OS, not pseudo-random.

Gematria supports Hebrew, Greek, and English systems. Numerology preserves master numbers (11, 22, 33).

Four complete divination systems.

☉

Natal charts, transits, synastry, composite, solar/lunar returns, progressions, horary.

🂡

Single card, 3-card, Celtic Cross, horseshoe, relationship spreads. True cryptographic shuffling.

Hebrew, Greek, and English systems. Compare words, lookup numbers, find correspondences.

∞

Life Path, Expression, Soul Urge, Personality. Personal Year/Month/Day cycles.

Commands you'll actually use.

thoth chart --date 1879-03-14 --time 11:30 --city "Ulm" --nation DE

thoth transit --natal-date 1879-03-14 --natal-time 11:30 --city "Ulm" --nation DE

thoth tarot -s celtic -q "What should I focus on?"

thoth gematria "Hello World"

thoth gematria-lookup 26

thoth numerology --date 1879-03-14 --name "Albert Einstein"

thoth moon

Instant onboarding for Claude Code, OpenClaw, and other AI agents.

Point your agent to the skill file for complete thoth-cli instructions:

https://thothcli.com/skill.md

Raw markdown file with all commands, ACP services, and the golden rule: CLI provides DATA, agent provides INTERPRETATION.