Destiny: Claude Code Plugin for Deterministic Fortune Telling Using Classical East Asian Astrology

Destiny is a plugin for Claude Code that delivers daily fortune readings based on classical East Asian astrology — not an LLM-hallucinated horoscope. The numbers are computed deterministically by a Python script; only the interpretation is generative. Type /destiny to get a today-specific reading.

Quick Start

Requires Claude Code v2.0+ with plugins enabled. Install inside Claude Code:

/plugin marketplace add xodn348/destiny
/plugin install destiny@destiny-marketplace
/destiny

From terminal (fallback):

claude plugin marketplace add xodn348/destiny
claude plugin install destiny@destiny-marketplace

Verify with claude plugin list. First /destiny asks for birth date, time, city, and gender — saved to ~/.destiny/profile.json. Subsequent calls need only /destiny.

What You Get

Each reading has two sections:

• Today's Fortune — short prose based on today vs. your birth chart, with five-category stars (overall, love, money, career, health), a hexagram for this moment, lucky number/color/direction.
• Life Reading — character, life arc, current 10-year period. Plain language.

How It Works

Three deterministic systems, computed from birth date/time:

• Four Pillars (eight-character birth chart) — year/month/day/hour map to Heavenly Stems and Earthly Branches from a 60-cycle calendar running continuously for 2000+ years.
• Perpetual lunar calendar — converts solar dates to eight characters, handles solar terms, lunar/solar conversion, true-solar-time correction by longitude, Korean DST (1987–88). Equivalent to Korea's national observatory calendar.
• I-Ching hexagram — drawn via plum-blossom time divination (Shao Yong's algorithm) from current lunar date/hour. Hexagram texts from James Legge's 1899 public-domain translation.

Layer separation: eight-character birth chart, today's day pillar, five-element relationships, branch harmonies/clashes — all computed by Python. Claude applies classical reading conventions to that fixed data.