thoth-cli

Hermetic divination CLI: astrology (natal, transits, electional, returns, synastry), tarot (cryptographic random), gematria (Hebrew/Greek/English), numerolog...

Security Scan

The skill is internally consistent: it is an instruction-only wrapper for the thoth-cli npm package and only requires the thoth binary which matches its stated purpose.

Purpose & Capability

Name/description (divination CLI) match the declared requirement of a 'thoth' binary and the npm package 'thoth-cli'. There are no unrelated credentials, binaries, or config paths requested.

Instruction Scope

SKILL.md only instructs the agent to run the thoth CLI commands and interpret their outputs. It does not tell the agent to read unrelated files, environment variables, or send data to unexpected endpoints. Note: runtime behavior depends on the installed CLI binary.

Install Mechanism

Install is via the public npm package 'thoth-cli' (expected for a Node CLI). This is a typical and traceable mechanism; installing an npm package will place code on disk and may run lifecycle scripts (postinstall), so normal npm-package risks apply.

Credentials

No environment variables, credentials, or config paths are requested by the skill. The lack of secrets is proportionate to a local CLI wrapper.

Persistence & Privilege

The skill is not always-enabled and does not request elevated persistence or modify other skills. It can be invoked by the agent (normal behavior) but does not claim permanent system presence.

Assessment

This skill appears to be a straightforward wrapper for the thoth-cli npm package. Before installing: (1) Inspect the npm package page and the linked GitHub repo (look for postinstall scripts, network calls, or unexpected dependencies). (2) Prefer running via npx or in a sandbox/container if you want to avoid a global install. (3) Avoid installing as root; review package.json and published files if you need higher assurance. (4) Remember the agent will run the installed binary when invoked—if you don't trust the package author, audit the package source first.

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