How do I install the Thoth CLI skill?

Run npx skillmds@latest add dvcrn/thoth-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Thoth CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Thoth CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Thoth CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Thoth CLI?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Thoth CLI by dvcrn — Agent Skill

Name: Thoth CLI
Rating: 4.2 (5 reviews)
Author: dvcrn

Thoth CLI

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.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

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-cli

The 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 DE

Transits

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

Electional (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 3

Relationships

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 2027

Tarot

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 spreads

Gematria

thoth gematria "THOTH"
thoth gematria "Love" --compare "Will"
thoth gematria-lookup 93

Numerology

thoth numerology --date 1991-07-08 --name "Full Name"
thoth numerology-year --date 1991-07-08

Full Documentation

For complete CLI documentation and all commands: https://thothcli.com/skill.md

---name: thoth-clidescription: 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.---# 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```bashnpm install -g thoth-cli```The package is published on npm by `aklo360`. Verify at: https://www.npmjs.com/package/thoth-cli---## Astrology### Natal Chart```bashthoth chart --date 1879-03-14 --time 11:30 --city "Ulm" --nation DE```### Transits```bashthoth transit --natal-date 1879-03-14 --natal-time 11:30 --city "Ulm" --nation DE```### Electional (Optimal Timing)```bashthoth electional --start 2026-03-15 --end 2026-04-15thoth 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```bashthoth solar-return --natal-date 1879-03-14 --natal-time 11:30 --city "Ulm" --nation DE --year 2026thoth lunar-return --natal-date 1879-03-14 --natal-time 11:30 --city "Ulm" --nation DE --year 2026 --month 3```### Relationships```bashthoth synastry --date1 ... --date2 ...thoth composite --date1 ... --date2 ...thoth score --date1 ... --date2 ...```### Other```bashthoth horary --question "Should I?" --city "NYC"thoth moon -ethoth ephemeris --body plutothoth ephemeris-multi --bodies sun,moon,mercury --from 2026-03-01 --to 2026-03-31thoth transit-scan --natal-date ... --start-year 2026 --end-year 2027```---## Tarot```bashthoth tarot # Single cardthoth tarot -s 3-card # Past/Present/Futurethoth tarot -s celtic # Celtic Cross (10)thoth tarot -q "Question?" # With contextthoth tarot-card "The Tower" # Card lookupthoth tarot-spreads # List spreads```---## Gematria```bashthoth gematria "THOTH"thoth gematria "Love" --compare "Will"thoth gematria-lookup 93```---## Numerology```bashthoth numerology --date 1991-07-08 --name "Full Name"thoth numerology-year --date 1991-07-08```---## Full DocumentationFor complete CLI documentation and all commands: https://thothcli.com/skill.md

Frequently asked questions