A hermetic divination command-line interface providing empirical data for astrology, tarot, gematria, and numerology.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install thoth-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install thoth-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is thoth-cli?
thoth-cli is a specialized technical tool designed to integrate ancient hermetic wisdom with modern computational precision. It serves as a reliable data provider for Openclaw Skills, ensuring that AI agents base their interpretations on empirical calculations rather than hallucinations. By utilizing the Swiss Ephemeris for astronomical accuracy and cryptographically secure random number generators for tarot, it provides a robust framework for esoteric analysis.
The core philosophy of this tool is the Golden Rule: the CLI provides the empirical data, and the AI agent provides the interpretation. This separation of concerns ensures high-fidelity results for any developer or practitioner building systems within the Openclaw Skills ecosystem.
thoth-cli Use Cases
- Generating precise natal charts and transit reports based on specific geographical coordinates.
- Identifying optimal timing for events through electional astrology calculations.
- Conducting unbiased tarot readings using system-level cryptographic randomness.
- Exploring linguistic connections through Hebrew, Greek, and English gematria systems.
- Calculating Pythagorean numerology profiles for personal development and cycle analysis.
How thoth-cli Works
- The user or agent triggers a specific command through the thoth interface.
- The CLI accesses specialized libraries like the Swiss Ephemeris for planetary data or secrets.SystemRandom for tarot draws.
- Accurate values are calculated for the requested date, time, and location.
- The raw data is outputted to the terminal or provided in JSON format for the agent.
- The agent utilizes these results within the Openclaw Skills framework to provide a nuanced Hermetic interpretation.
thoth-cli Setup
To get started with this tool in your Openclaw Skills environment, install it globally using npm:
npm install -g thoth-cli
Once installed, you can verify the installation by running thoth --help to see the available modules.
thoth-cli Data Schema & Taxonomy
The thoth-cli organizes its output based on the specific esoteric discipline requested. It supports structured data formats to ensure compatibility with various Openclaw Skills workflows.
| Module | Output Type | Key Information Captured |
|---|---|---|
| Astrology | Planetary Data | Longitude, latitude, house placement, and aspects using Swiss Ephemeris. |
| Tarot | Random Draw | Card names and positions within spreads like the Celtic Cross. |
| Gematria | Numeric Values | Total values and comparative matches across multiple cipher systems. |
| Numerology | Cycle Analysis | Life path numbers, personal year cycles, and name vibrations. |
thoth-cli Advanced Features
- Support for JSON output flags to enable programmatic data handling for Openclaw Skills integrations.
- Comprehensive electional astrology engine that scores time periods based on planetary quality.
- Multi-body ephemeris scanning for identifying long-term celestial patterns.
- Cryptographically secure card shuffling for digital tarot accuracy.
- Synastry and composite chart calculations for relationship dynamics analysis.
SKILL.md
Loading
Related Openclaw Skills
openvid
An AI-powered service for generating branded motion graphics videos from text prompts and public URLs using the x402 payment protocol.
OpenGFX Logo System
A comprehensive AI skill for generating production-ready SVG logo systems, icons, and brand lockups from natural language prompts.
Plex Media Server Control (plexctl)
A standalone command-line interface for controlling Plex Media Server and remote clients through direct API integration.
Sourdough Starter Manager
A technical fermentation assistant for managing sourdough feeding schedules, hydration ratios, and culture health diagnostics.
Blockscout Blockchain Analysis
A comprehensive framework for analyzing EVM blockchain activity and building data-driven applications via the Blockscout MCP server.
Voice STT & TTS for OpenClaw
A full-stack voice integration enabling AI agents to transcribe incoming audio and reply with high-quality synthetic speech.
Featured*
