# Ascendant

- [Getting started](https://astro-ascendant.vercel.app/docs): Generate a horoscope, build with the Effect-first TypeScript library, or let an AI assistant read your chart. Choose your path.
- [Quickstart](https://astro-ascendant.vercel.app/docs/quickstart): Install Ascendant and calculate your first chart and Vimshottari dasha in a few minutes.
- [Core concepts](https://astro-ascendant.vercel.app/docs/concepts): The vocabulary Ascendant shares across its API and guides, from Located Moments and Placements to schools and provenance.
- [Build with an agent](https://astro-ascendant.vercel.app/docs/agents): Give your coding agent the Ascendant docs, a prompt that sets the rules, and a checklist for reviewing what it writes.
- [Skills and plugins](https://astro-ascendant.vercel.app/docs/skills): Install the Ascendant plugins for OpenCode, Claude Code, and Codex, or the skill for any other agent.
- Developer guides
  - [Choose a school and settings](https://astro-ascendant.vercel.app/docs/guides/settings): Pick an ayanamsa and house system, set them once, and keep KP and Parashari results apart.
  - [From local time to a Located Moment](https://astro-ascendant.vercel.app/docs/guides/located-moments): Turn a birth date, local time, and place into the UTC moment and coordinates Ascendant calculates from.
  - [Divisional charts](https://astro-ascendant.vercel.app/docs/guides/divisional-charts): Generate D9 and the other divisional charts, read their whole-sign houses, and map a single longitude into a division.
  - [Dashas](https://astro-ascendant.vercel.app/docs/guides/dashas): Calculate Vimshottari, Chara, and Sthira dasha timelines from shared placements and query the period active on any date.
  - [Ashtakavarga](https://astro-ascendant.vercel.app/docs/guides/ashtakavarga): Calculate Bhinnashtakavarga, Sarvashtakavarga, reduced tables, and Shodhya Pinda from shared placements, and read them by sign and house.
  - [Jaimini calculations](https://astro-ascendant.vercel.app/docs/guides/jaimini): Calculate Chara Karakas, Rashi Drishti, Karakamsha, Arudha Pada, Upapada, and Argala from shared placements, one named result at a time.
  - [Transit searches](https://astro-ascendant.vercel.app/docs/guides/transits): Find the next or previous sign ingresses, longitude hits, house-cusp crossings, and stations of one graha, and attach charts to each event.
  - [Errors and typed failures](https://astro-ascendant.vercel.app/docs/guides/errors): Know which errors each Ascendant function can fail with, handle them by tag, and tell expected failures from defects.
  - [Ephemeris adapters and caching](https://astro-ascendant.vercel.app/docs/guides/ephemeris-and-caching): Choose between the plain and cached Swiss Ephemeris layers, tune the position cache, and write your own ephemeris adapter.
  - [Provenance and verification](https://astro-ascendant.vercel.app/docs/guides/provenance): Read the school, method, and version attached to results, look up the method specification behind them, and store what you need to repeat a calculation.
- API reference
  - [AstroParams](https://astro-ascendant.vercel.app/docs/api-reference/astro-params): Astro parameter configuration for ayanamsa and house-system selection.
  - [Chart](https://astro-ascendant.vercel.app/docs/api-reference/chart): Chart generation and placement models for D1 and divisional charts.
  - [Dasha](https://astro-ascendant.vercel.app/docs/api-reference/dasha): Vimshottari, Chara, and Sthira dasha calculations and queries.
  - [Ephemeris](https://astro-ascendant.vercel.app/docs/api-reference/ephemeris): Ephemeris service contract and runtime-neutral position models.
  - [Jaimini](https://astro-ascendant.vercel.app/docs/api-reference/jaimini): Jaimini calculations for Chara Karakas, Rashi Drishti, Karakamsha, Arudha Pada, Upapada, and Argala.
  - [Provenance](https://astro-ascendant.vercel.app/docs/api-reference/provenance): Method specification and provenance records attached to calculations.
  - [SAV](https://astro-ascendant.vercel.app/docs/api-reference/sav): Ashtakavarga and Shodhya Pinda calculations for shared chart placements.
  - [Swisseph](https://astro-ascendant.vercel.app/docs/api-reference/swisseph): Swiss Ephemeris integration layer for the TypeScript astrology library.
  - [Transit](https://astro-ascendant.vercel.app/docs/api-reference/transit): Mechanics-only search for the next or previous transit events of one graha.