Skip to content

CHANGELOG.md

Latest commit

 

History

History
184 lines (139 loc) · 5.58 KB

CHANGELOG.md

File metadata and controls

184 lines (139 loc) · 5.58 KB
Raw

Changelog

All notable changes to thoth-cli will be documented in this file.

Unreleased

Changed

  • Synced packages/cli/package-lock.json root metadata to package version 0.2.27 during Mini setup.
  • Made linked development checkouts prefer the local Python core virtualenv before the packaged PyInstaller binary, keeping source-only commands available during local setup.
  • Single-sourced the CLI version displayed by thoth --version and the startup banner.

[0.2.1] - 2026-03-02

Added

  • thoth composite — Composite (midpoint) charts for relationships

    • Creates a single "relationship entity" chart
    • Each planet is the midpoint between both people's placements
    • SVG output support

  • thoth solar-arc — Solar arc directions

    • All planets move forward by the Sun's arc (~1°/year)
    • Directed-to-natal aspect detection
    • Naibod method (1°/year)

  • thoth horary — Horary astrology for divination

    • Cast a chart for the moment a question is asked
    • Traditional house rulership system
    • Moon void-of-course detection
    • Strictures against judgment (early/late ASC, Saturn positions, Via Combusta)
    • Planetary hour calculation
    • Moon aspects with applying/separating detection
    • Guidance for reading the chart

[0.2.0] - 2026-03-02

🌟 Major Feature Release

New Commands

  • thoth solar-return — Calculate annual solar return charts

    • Full chart for when Sun returns to natal position
    • Year-ahead forecasting
    • Location override support

  • thoth lunar-return — Calculate lunar return charts

    • Full chart for when Moon returns to natal position (~monthly)
    • Month-ahead emotional weather forecasting
    • Search from any date

  • thoth synastry — Relationship chart analysis

    • Inter-chart aspects between two people
    • Key position comparison
    • Configurable orb

  • thoth progressions — Secondary progressions

    • Day-for-a-year method
    • Progressed-to-natal aspects
    • Age calculation

  • thoth ephemeris-range — Track planetary positions over time

    • Sign ingress detection
    • Retrograde station detection
    • Configurable step (day/week/month)

New Features

  • SVG Chart Generation — Beautiful wheel charts via Kerykeion
    • All chart commands now support --svg flag
    • --svg-file <path> to save directly to file
    • Natal, Transit, Synastry, and Return charts

Technical

  • Python core updated to v0.2.0
  • Improved TypeScript type definitions
  • Better error handling

[0.1.0] - 2026-02-27

🌟 Initial Release

The first public release of thoth-cli — a Hermetic astrology CLI built on Kerykeion and Swiss Ephemeris.

Features

Commands

  • thoth chart — Calculate comprehensive natal charts

    • All 10 planets + Chiron, Lilith, North/South Nodes
    • All 12 houses (Placidus)
    • Natal aspects between all bodies
    • Element balance (Fire/Earth/Air/Water)
    • Modality balance (Cardinal/Fixed/Mutable)
    • Lunar phase at birth
    • City geocoding (no coordinates needed)

  • thoth transit — Calculate transits to natal chart

    • Current sky positions with house placements
    • Transit-to-natal aspects with configurable orb
    • Side-by-side house comparison (transit vs natal)
    • Current lunar phase
    • Retrograde indicators

  • thoth moon — Current moon phase and position

    • Phase name and illumination percentage
    • Sign and degree

  • thoth ephemeris — Ephemeris for any body

    • Position by sign and degree
    • Absolute zodiacal position
    • Retrograde status

  • thoth key — Complete symbol reference guide

    • All planets with meanings, rulerships, and Sephirotic correspondences
    • All zodiac signs with element, modality, ruler, and mantra
    • All 12 houses with life areas
    • All aspects with degrees and Hermetic interpretations
    • Elements with temperaments and Jungian functions
    • Modalities with seasonal correspondences
    • Dignities (Domicile, Exaltation, Detriment, Fall)

Design

  • Kabbalistic color system — Colors mapped to Sephirotic correspondences:

    • ☉ Sun = Gold (Tiphareth)
    • ☽ Moon = Silver (Yesod)
    • ☿ Mercury = Orange (Hod)
    • ♀ Venus = Green (Netzach)
    • ♂ Mars = Red (Geburah)
    • ♃ Jupiter = Royal Blue (Chesed)
    • ♄ Saturn = Indigo (Binah)
    • ♅ Uranus = Cyan (Chokmah)
    • ♆ Neptune = Sea Green
    • ♇ Pluto = Dark Red

  • Consistent notation throughout

    • Zodiac: ♈♉♊♋♌♍♎♏♐♑♒♓
    • Planets: ☉☽☿♀♂♃♄♅♆♇
    • Points: ⚷ (Chiron), ⚸ (Lilith), ☊☋ (Nodes)
    • Aspects: ☌ (CNJ), ☍ (OPP), △ (TRI), □ (SQR), ⚹ (SXT), ⍟ (QNT), ⚻ (QCX)
    • Elements: 🜂 (Fire), 🜃 (Earth), 🜁 (Air), 🜄 (Water)

  • Clean, lean output — Information-dense without clutter

  • JSON output — --json flag for programmatic use

Technical

  • Python core using Kerykeion + Swiss Ephemeris
  • TypeScript CLI wrapper with Commander.js
  • City geocoding via Geonames (built into Kerykeion)
  • Cross-platform: macOS, Linux, Windows

Architecture

thoth-cli/
├── packages/
│   ├── core/          # Python (Kerykeion calculations)
│   │   └── thoth_core/
│   │       └── cli.py
│   └── cli/           # TypeScript (user interface)
│       └── src/
│           ├── bin.ts
│           └── lib/
│               ├── core.ts
│               └── format.ts

Privacy

No data collection. Ever. All calculations run locally. No analytics, no telemetry, no tracking.

License

MIT — Free for any use.

"As above, so below; as the universe, so the soul."