AI-Generated Reports
Your Cosmos
Getting Started
Your Cosmos makes astrology visible. It lets you explore your astrology on an interactive graph and then generate personalized AI reports for any transit or aspect.
How the layout works
This app has three main areas:
- The natal wheel on the left shows your birth chart and the position of transiting planets.
- The main graph in the center shows how transits and aspects change over time.
- The right panel shows a list of active transits or aspects.
How to begin
- Choose a mode using the top-right buttons.
- Pan or zoom the graph to the period you want to study.
- In the right panel, choose up to four transits/aspects to explore on the graph.
- Hover over the graph window to learn more about your selected transits.
- Click in the graph window to generate an AI report for the selected graphs.
Two ways to create AI reports
Click on specific transits/aspects in the right panel to see them in the main graph window. Then click in the graph window to generate a report focused on those particular factors. Click Generate a holistic report when you want a synthesis of the most important factors visible in the right panel.
The Five Modes
The tabs at the top of the right panel switch between five distinct ways of reading your astrological data. Each mode changes what the graph displays and what the AI reports describe.
Personal Transits
This compares the current sky to your natal chart. It shows how today’s planets are activating your own birth chart, which makes it the most personal mode.
World Transits
This shows aspects between planets in the current sky. It describes collective atmosphere rather than your private life.
Natal Aspects
This shows the permanent aspects in your birth chart. It is not time-based in the same way as transit modes. Use it to understand enduring character structure, gifts, tensions, and repeating themes.
Synastry
This compares your natal chart with another person’s chart. It shows how one chart interacts with the other and is useful for romantic, familial, friendship, or work relationships.
Inside Synastry, you can also explore a composite chart. This creates a chart for the relationship itself and then tracks transits to that shared field.
Optimal Timing
This mode helps you find supportive windows for a specific life event or intention. You choose the event and the time frame, and the app highlights stronger and weaker time periods.
Reading the Graph
The basic idea
Astrology posits that when planets form meaningful geometric relationships in the sky, their energies come into relationship in our lived experience. The graph shows those relationships as moving patterns over time.
The main aspect types
The app highlights five major angular relationships, each in its own color:
- Conjunction (0°) — orange
- Sextile (60°) — yellow
- Square (90°) — purple
- Trine (120°) — green
- Opposition (180°) — blue
The Y-axis (orb)
Each curve represents one aspect between two planets. The curve shows how exact that aspect is across time. The top of the graph is 0° orb — exact. The lower the curve, the wider the orb and the weaker the aspect. In simple terms: the higher the curve, the stronger the aspect.
The X-axis (time)
Time moves left to right. The date labels along the top of the graph tell you where you are in the timeline. The bright blue ertical line marks the currently selected date (today by default).
Hovering
Move your cursor across the graph to see a live data readout: exact orb at that date, whether the transit is applying (tightening) or separating (loosening), the pass number, and how many days until the next exact hit.
The Right Panel
The right panel shows the transits or aspects that are currently relevant within the selected time window. Each row contains a small strip that compresses one active transit’s orb curve into a compact visual summary.
As you pan and zoom the graph, the panel updates in real time, giving you a quick overview of what is active in that period.
How the right panel relates to the graph
When you click any row in the right panel, that row’s graph appears in the main graph window. You can display up to four graphs at once. To remove a graph, click its row again.
View Modes
The VIEW MODE dropdown at the top of the right panel controls how many transits or aspects are shown.
Curated views show a curated selection of the most important factors.
The All Transits views show every transit active in the selected time window.
Transits Active on Center Date shows only the transits that are within orb on the center date.
If the full list feels overwhelming, start with one of the curated views.
Holistic reports
At the bottom of the right panel, you can generate an AI report that synthesizes all of the currently visible transits or aspects.
AI Reports
Your Cosmos uses AI to generate written customized astrological interpretations on the fly. The controls in the lower-left panel let you tune the depth, length, focus, and interpretive style of every report.
Focused vs. holistic reports
Focused reports are created by selecting up to four transits/aspects and then clicking in the graph window. Use a focused report when you want interpretation centered on a hand-selected set of transits/aspects. Use a holistic report when you want a synthesis of the whole astrological field.
Report Length (1–7)
Controls how much the AI writes, ranging from a few sentences to a thousand-word essay.
Complexity (1–10)
This is the most important slider. It governs the depth and sophistication of astrological technique used in the report:
- C1–C2: Plain language, no jargon. The transit is described in accessible terms anyone can understand — no prior knowledge of astrology required.
- C3–C4: Basic astrological vocabulary introduced. Aspect names, applying/separating direction, and elementary planet meanings are used.
- C5–C6: Sign placements and house topics are incorporated. Traditional mode begins to judge dignity and debility at C6. Archetypal mode brings in mythic and psychological symbolism.
- C7–C8: Full technical delineation. Rulership chains, sect, testimony weighing, and mitigation factors are all considered and described explicitly.
- C9–C10: Advanced synthesis. Multiple layers of astrological evidence are woven together, alternative readings are considered and compared, and a final judgment is argued from the evidence.
Area of Interest
Focuses the report on a specific life domain instead of a general interpretation. When an area is selected, the AI reads the same transit data through the lens of that domain of life.
Interpretive Lens
Chooses the astrological tradition that shapes the interpretation's approach:
- Archetypal: Reads planets as mythic and psychological forces. Emphasizes inner development, symbolic resonance, and the experiential texture of a transit. Reports in this lens feel closer to depth psychology or narrative astrology.
- Traditional: Reads planets as rulers of houses and judges their condition by dignity, sect, and testimony. Reports in this lens feel closer to classical Hellenistic or Medieval astrology.
Report Tone
Controls the voice of the output. Although the underlying astrological interpretations are identical, each tone communicates quite differently, so it's worth experimenting to find the voice you like most.
The refresh icon
Use this to ggenerate the current report using different settings. This is a fast way to tweak a report's length, complexity, or tone.
The Natal Wheel
The circular chart in the left panel is your natal wheel. In the light blue ring, you cab see the position of the planets at the exact moment of your birth. When you hover over a graph in the main graph window, you can see the relevant planets move across the wheel's dark outer ring.
Reading the wheel
Inside the natal planet ring, you can see the twelve zodiac signs. Further in, you can see the twelve houses, each representing a domain of life (if you provided a birth time).
Learning about your natal chart
Hover of any symbol in the natal wheel to learn more about it. Click on any symbol to generate a personalized AI report on that part of your birth chart.
Birth data accuracy
The accuracy of your natal wheel depends on the precision of your birth data. An exact birth time is needed to calculate house cusps and the Ascendant correctly. If you do not have a birth time, the houses and Ascendant will not be shown; the planet positions will still be accurate to the day.
Bookmarks
Bookmarks let you save and instantly return to any chart configuration.
Saving a bookmark
Click the Bookmarks tab in the lower-left panel. Press the save button (+ or bookmark icon) to capture the current state. You can give the bookmark a name — something descriptive like "Jupiter conjunct Sun exact", "Saturn return begins", or "Wedding day transits" — so you can find it quickly later.
What gets saved
A bookmark captures the current date, zoom level, mode, selected factors, and report settings. Restoring a bookmark restores all of these together.
Using bookmarks
Click any saved bookmark to jump immediately to that configuration. This is especially useful for returning to a significant transit period you've already researched, sharing a specific chart view with someone, or building a collection of personally meaningful astrological moments.
Settings
The Settings panel allows you to controls both how the app interprets astrology and how the interface looks and behaves.
Expertise / Complexity
The most important setting in this panel is the Expertise slider. This setting determines how advanced the app’s astrological reasoning should be. At lower levels, explanations stay simple, clear, and beginner-friendly. At higher levels, the app uses more technical language and more advanced astrological logic. If the app ever feels too basic or too dense, this is the setting to adjust.
Orb Thresholds
The orb threshold settings control how close an aspect must be to count as active. Wider orbs make the app show more transits and aspects; tighter orbs make it more selective. These thresholds affect what appears in the graph, in the right panel, and in generated interpretations.
Included Bodies
This section lets you choose whether to include additional points such as the North Node, Part of Fortune, and Chiron. Turning these on expands what can appear in the graph, the wheel, and reports.
House System
The house system setting determines how the natal wheel divides life into twelve houses. Different systems can place planets in different houses or shift which sign appears on a house cusp.
Chart Selection and Sharing
In the My Charts tab, you can switch between charts, edits your saved charts, and share charts with other users.
Interface Preferences
You can also adjust the feel of the interface here. This includes dark or light theme, default font size, and other display preferences.
Glossary
A quick reference for astrological terms used throughout the app.
- Aspect
- An angular relationship between two planets.
- Orb
- How close an aspect is to exactness. Smaller orb means stronger intensity.
- Applying vs. Separating
- Applying means the aspect is moving toward exactness. Separating means it is moving away from it.
- Transit
- A moving planet in the current sky, especially when it forms an aspect to something in a chart.
- Exactitude / Exact Hit
- The moment an aspect reaches exact precision.
- Transit Pass
- A single passage of a transiting planet through an aspect. Slow-moving planets (Saturn, Uranus, Neptune, Pluto) can make the same aspect 2 or 3 times due to retrograde motion. The pass number (e.g., 1/3, 2/3, 3/3) tells you which occurrence you are currently viewing.
- Direct / Retrograde
- A planet moving in its normal forward direction through the zodiac is Direct. A planet that appears (from Earth's perspective) to move backward is Retrograde, often shown as ℞. When a planet slows to a near-stop before changing direction, it is said to be Stationing — generally considered a particularly intense period for that planet's themes.
- Natal Chart
- The map of the sky at the moment of your birth.
- Houses
- The twelve chart divisions associated with different life areas.
- Dignity / Debility
- Traditional terms for whether a planet is strengthened or weakened by sign placement.
- Sect
- A Traditional distinction between day and night charts that affects planetary condition.
- Secondary Progressions
- A timing technique that symbolically advances the natal chart one day for each year of life.
- Synastry
- The comparison of two natal charts.
- Composite Chart
- A relationship chart built from the midpoints between two natal charts.
