Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/aklo360/thoth-cli/thoth-clinpx skills add aklo360/thoth-cli --skill thoth-cligit clone --depth 1 https://github.com/aklo360/thoth-cliWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00062 | $0.00972 |
| Opus 5 | $0.00031 | $0.00486 |
| Sonnet 5 | $0.00012 | $0.00194 |
| Haiku 4.5 | $0.00006 | $0.00097 |
Grade A, and why
thoth-cli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 129 lines — stays where its author put it; the contents beside it link to each section on GitHub.
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
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday First seen · 129 lines · 62 tokens per session scan A 22fad3480bdb
thoth-cli is a skill published in the GitHub repository aklo360/thoth-cli (5 stars, last pushed 1mo ago), licensed MIT. It adds 62 tokens to every session and 972 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
astral
Local-first natal charts, transits, synastry and moon phases. No API key. Prefer MCP tools if connected; otherwise the package CLI.
astrology
Trustworthy multi-tradition astrology. Casts mathematically real charts (Western tropical, Vedic/Jyotish sidereal, Chinese BaZi) from birth data via a deterministic ephemeris engine — never guessed positions — then interprets them with grounded classical rulesets and counsels like a real astrologer. Use for…
spouse-profiling
Use when the user wants to know what their future spouse looks like, their personality, archetype, traits, career, lifestyle, or any detailed profile of the spouse based on the native's chart.
past-life-analysis
Use when analyzing past life karma, karmic debts, soul's unfinished business, past life talents, or the karmic story carried into this birth.
career-analysis
Use when analyzing career, profession, work, job, business prospects, or professional guidance.
full-reading
Use when performing a complete natal chart reading, general life overview, or full birth chart guidance.