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
- On every visit, the app will provide an opening report for you.
- Choose one of the follow-up options under that report, or type your own question in the box below the report. The app will generate a new report focused on that question or direction.
- Keep going by clicking the next set of follow-up options, or ask a more specific question at any point.
- Use the graph, wheel, and transit list whenever you want to inspect the astrology behind what the report is describing.
- You can also manually add transits to the graph window and then generate a report by clicking anywhere in the graph window.
The Five Modes
The tabs at the top of the right panel switch between five distinct ways of viewing your astrological data. The dropdown menu in the top row switches between five distinct ways of viewing 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.
Using 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°) — purple
- Sextile (60°) — yellow
- Square (90°) — orange
- 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 Exploring
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.
When you tap or drag across the graph, the INFO tab will show detailed transit information. In the WHEELS tab, you can see real-time positions of all the relevant planets and the angular relationships between them.
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. Use the Astrological Depth control above the report to tune how much astrological structure enters the reading, and use the lower-left panel to adjust length, focus, and voice.
Report Length (1-10)
Controls how much the AI writes, ranging from a few sentences to a thousand-word essay.
Astrological Depth (0–10)
This is the most important slider. It governs how many astrological layers the report is allowed to use, and how explicitly those layers are discussed:
- 0–2: The reading stays highly accessible. It begins in plain experiential language, then introduces planets and aspects without assuming prior astrological knowledge.
- 3–4: Signs and modalities enter the picture. The report begins to describe not just what is happening, but the style, mood, and movement pattern of the symbolism.
- 5–6: Houses and life arenas are added. The report becomes more concrete about where the pattern is being lived and how different parts of life interact.
- 7–8: Advanced connective technique appears. Multiple factors are synthesized, and traditional concepts like essential dignity and rulership may be used when they genuinely deepen the reading.
- 9–10: Full practitioner depth. Sect, testimony, non-obvious insight, and fine interpretive discrimination may appear, but only selectively and in service of one unified judgment.
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.
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 Rewrite Button
Use this to regenerate 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.
Using 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
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.
