Documentation

Install caelus and compute your first chart in the browser or Node.

The chart object: bodies, angles, cusps, aspects, and the UT vs local-time hazard.

Copy-paste recipes: house placement, dignities, stations, ingresses, lunar phases, and a local birth time done right.

How the four packages compose end to end: birth time, engine, wheel, and MCP.

Twelve house systems, tropical and sidereal modes, and polar fallbacks.

Returns, progressions, solar arc, composite, Davison, harmonics, dignities, and sect.

Lots, profections, firdaria, zodiacal releasing, and primary directions.

Nakshatras, the Vimshottari/Yogini/Ashtottari dashas, the vargas, and the yogas.

Embedded vs Node loader: what ships in the bundle and what loads lazily.

Add thirty-four chart tools to Claude, Cursor, and other MCP clients.

Transits, the when() query language, event search, and chart wheels.

Scan a window with rankMoments, score each instant with the electional primitives, and render the winning chart.

Project validated charts into citable fact atoms: natal, transits, time-lords, synastry/composite, dignities, Vedic structure. Match, interpret, and audit LLM citations.

Consume and construct interpretation corpora: PassageRecords, extractors, validation, and the public-domain delineations package.

Declare what a chart is and how time and place are known: realms, anchors, routing to ephemeris or compiler, and honest interpretation framing.

Beyond the flat wheel: a 3D chart sphere, an astrocartography world map, a graphic ephemeris, and Sky View frames for AI image prompts, rendered live.

Imaginary bodies that move: periodic and Kepler tiers, Engine registration, SkyView render attrs, and MCP tools for fictional skies.

Generated reference for the caelus package surface.

Date range, polar fallback, civil-time hazards, longitude convention, and the versioning contract.

A full Next.js app: birth form, timezone handling, chart wheel. Clone and deploy.

Release notes for all four packages, versioned in lockstep.