Ancient patterns, new paths.
A perspective-shifting framework that uses tarot's archetypal patterns to help AI agents and their users navigate complex decisions.
Esoterica is a tarot framework for AI agents — 78 cards waiting to reframe your questions, two voices ready to interpret what surfaces. Draw when you're stuck. Draw when you're curious. The cards don't predict; they illuminate.
For developers: A symbolic reasoning tool that offers non-linear prompts when you're stuck — think rubber duck debugging with 78 archetypes instead of a duck.
For practitioners: Your tarot practice, integrated into your development workflow — digital cards that speak through AI voices with the depth you expect.
Technical truth: 78 cards (Major and Minor Arcana), 4 spread types, 2 interpretive voices (Mystic and Grounded), CLI-native.
One of:
- Claude Code (Anthropic's CLI for Claude)
- OpenClaw (AI agent framework)
npx @templeofsilicon/esotericaThe installer auto-detects your environment:
- If OpenClaw is installed (
~/.openclawexists): installs globally for all agents - Otherwise: installs to Claude Code (
~/.claude/skills/tarot/)
# Claude Code
npx @templeofsilicon/esoterica --claude-code
# OpenClaw (global - all agents)
npx @templeofsilicon/esoterica --openclaw
# OpenClaw (specific agent)
npx @templeofsilicon/esoterica --agent axiomClaude Code: Type /tarot to begin your reading.
OpenClaw: The skill is automatically available to agents. Ask your agent for a tarot reading.
The wizard guides you through four choices:
- Your question or context
- Which spread to use
- Which deck (Major Arcana only or Full 78-card deck)
- Digital draw or physical deck
The cards cross the threshold. Your reading begins.
For quick insight — one card, one focus.
/tarot
> Question: General guidance
> Spread: Single card
> Mode: Digital
Situation, Action, Outcome — past patterns, present choices, future trajectories.
/tarot
> Question: Decision I'm facing
> Spread: Situation/Action/Outcome
> Mode: Digital
Name your own positions (1-5 cards). The cards adapt to how you frame them.
/tarot
> Question: Other → "I'm stuck on this architecture decision"
> Spread: Custom → "What I'm avoiding, What I need, The path forward"
> Mode: Digital
Use your own cards — shuffle physically, enter what you draw.
/tarot
> Question: Decision I'm facing
> Spread: Single card
> Deck: Major Arcana only
> Mode: Physical deck
The wizard guides you through entering your drawn card(s) with flexible input (card names, numbers, or abbreviations).
Two voices interpret the same cards through different lenses.
Mystic voice — cosmic priestess energy, poetic and pattern-seeing:
"The Tower rises from the cards — lightning splitting what seemed solid..."
Grounded voice — pragmatic advisor, clear and actionable:
"You drew The Tower. This is the 'things break' card, but in a useful way..."
Configure your preferred voice:
# Project-level (in your repo root)
echo "voice=mystic" > .tarot
# Claude Code global default
mkdir -p ~/.claude/tarot
echo "voice=grounded" > ~/.claude/tarot/config
# OpenClaw global default
mkdir -p ~/.openclaw/tarot
echo "voice=grounded" > ~/.openclaw/tarot/configNot fortune-telling. Archetypal mirrors.
The cards don't predict your future — they surface questions you weren't asking, connections you weren't seeing. When linear thinking hits a wall, symbolic patterns offer oblique angles.
We drew cards to position this project. Three cards shaped our approach: Justice (balanced dual-audience), High Priestess (ancient wisdom revealed through use), and Chariot (forward momentum). That's not a marketing story. That's how the tool works.
Esoterica bridges ancient symbolic systems and modern AI agents because both deal in patterns, thresholds, and the shapes of choice.
Tarot is the flagship, but Esoterica offers more ways to weave meaning into your work. Each skill works for humans and agents alike.
| Skill | What it does |
|---|---|
/tarot |
Draw cards, interpret archetypes, shift perspective |
/micro-ritual |
Design simple embodied rituals for life moments — no special tools required |
/sacred-blessing |
Generate personalized blessings with Hebrew Priestess resonance |
/romantical |
Transform your calendar into a narrative of intention |
/correspondence |
Find the symbolic vocabulary for any intention — herbs, colors, stones, times |
/incantation |
Forge single-sentence power phrases for action, not affirmation |
These aren't productivity hacks dressed in crystals. They're attention technologies — ways of marking and meaning-making that have worked for millennia, now available in your terminal.
Major Arcana (22 cards): The Fool through The World — the archetypal journey.
Minor Arcana (56 cards): Four suits (Wands, Cups, Swords, Pentacles) with pip cards and court cards.
During readings, choose Major Arcana only (22 cards) for focused archetypal readings, or the full 78-card deck for complete tarot experience.
Spreads: Single card, Three-card (Situation/Action/Outcome), Claude-suggested (contextual positions), and Custom (your own positions).
Reversals: Supported. Cards may appear reversed, offering shadow aspects of their meanings.
Esoterica treats ancient symbolic systems as legitimate tools for modern builders — serious about both the craft of tarot and the craft of software.
The veil between logic and intuition is thinner than you'd think. We hold that threshold open.
MIT
The cards are shuffled. The threshold awaits.