- name
- thoth-cli
- version
- 0.2.26
- description
- Hermetic divination CLI: astrology (natal, transits, electional, returns, synastry), tarot (cryptographic random), gematria (Hebrew/Greek/English), numerology (Pythagorean). ALWAYS run CLI first—never fabricate positions or draws.
- author
- aklo360
- homepage
- https://thothcli.com
- repository
- https://github.com/aklo360/thoth-cli
- license
- MIT
- metadata
- openclaw
- emoji
- 𓅝
- requires
- bins
- ["thoth"]
- install
- kind
- node
- package
- thoth-cli
- bins
- ["thoth"]
- label
- Install thoth-cli from npm
- registry
- https://www.npmjs.com/package/thoth-cli
thoth-cli — Hermetic Divination Tools
𓅝 v0.2.26 | Swiss Ephemeris • secrets.SystemRandom • Classical Gematria • Pythagorean Numerology
Source: https://github.com/aklo360/thoth-cli npm: https://www.npmjs.com/package/thoth-cli Website: https://thothcli.com
⚖️ GOLDEN RULE
NEVER fabricate planetary positions, card draws, or calculated values. Run the CLI first, then interpret.
CLI = DATA (empirical) → Agent = INTERPRETATION (Hermetic)Installation
npm install -g thoth-cliThe package is published on npm by aklo360. Verify at: https://www.npmjs.com/package/thoth-cli
Astrology
Natal Chart
thoth chart --date 1879-03-14 --time 11:30 --city "Ulm" --nation DETransits
thoth transit --natal-date 1879-03-14 --natal-time 11:30 --city "Ulm" --nation DEElectional (Optimal Timing)
thoth electional --start 2026-03-15 --end 2026-04-15
thoth electional --start 2026-03-15 --end 2026-04-15 --city "NYC" --nation US --json*Outputs: VOC Moon, retrogrades, aspects, quality scores (excellent/good/challenging)*
Returns
thoth solar-return --natal-date 1879-03-14 --natal-time 11:30 --city "Ulm" --nation DE --year 2026
thoth lunar-return --natal-date 1879-03-14 --natal-time 11:30 --city "Ulm" --nation DE --year 2026 --month 3Relationships
thoth synastry --date1 ... --date2 ...
thoth composite --date1 ... --date2 ...
thoth score --date1 ... --date2 ...Other
thoth horary --question "Should I?" --city "NYC"
thoth moon -e
thoth ephemeris --body pluto
thoth ephemeris-multi --bodies sun,moon,mercury --from 2026-03-01 --to 2026-03-31
thoth transit-scan --natal-date ... --start-year 2026 --end-year 2027Tarot
thoth tarot # Single card
thoth tarot -s 3-card # Past/Present/Future
thoth tarot -s celtic # Celtic Cross (10)
thoth tarot -q "Question?" # With context
thoth tarot-card "The Tower" # Card lookup
thoth tarot-spreads # List spreadsGematria
thoth gematria "THOTH"
thoth gematria "Love" --compare "Will"
thoth gematria-lookup 93Numerology
thoth numerology --date 1991-07-08 --name "Full Name"
thoth numerology-year --date 1991-07-08Full Documentation
For complete CLI documentation and all commands: https://thothcli.com/skill.md