Astro Life Insights

Astro Life Insights ✨

Personalized daily astrology for YOUR life, with a positive twist.

What This Does

Calculates current planetary transits against YOUR natal chart and provides insights for:

Everything is framed positively. Challenging transits become growth opportunities. Saturn squares = building foundations. Mars oppositions = channeling passion.

Setup (One-Time, Required)

> ⚠️ This skill ships with no personal data. You must run setup before anything works. Your birth data stays on your machine only.

1. Install Dependencies

cd path/to/astro-life-insights
npm install

2. Configure Your Birth Chart

node configure.js

You'll be prompted for:

This saves to ~/.config/astro-life-insights/natal-chart.json

2. Test It

node daily.js

Should output your personalized insights for today!

Usage

Get Today's Insights (Human-Readable)

node daily.js

Output:

✨ Your Astrological Weather - March 13, 2026
💕 RELATIONSHIPS
Uranus square natal Mars (building)
→ Freedom and intimacy find balance.
→ Action: Break free from limiting patterns.
💼 WORK
Sun square natal Uranus (EXACT TODAY)
→ Building identity through productive challenge.
→ Action: Honor both your needs and commitments.
🌱 PERSONAL GROWTH
Neptune sextile natal Moon (building)
→ Intuition guides evolutionary path.
→ Action: Tune into subtle guidance.
🍀 LUCK
Venus square natal Neptune (building)
→ Fortune through clarifying values.
→ Action: Invest in what you truly value.
✨ OVERALL: 15 active transits today. Rich day for inner work.

Get Insights for Specific Date

node daily.js 2026-03-15

Check Upcoming Transits

node upcoming.js

Shows major transits coming in the next 30 days.

Get JSON Output (for dashboards and automation)

node daily-json.js

Returns structured JSON — perfect for integrating into dashboards, agents, or any app.

JSON Output Schema (daily-json.js)

{
  "date": "2026-03-13",
  "totalTransits": 15,
  "relationships": [
    {
      "transit": "Uranus square",
      "planet": "uranus",
      "natal": "mars",
      "insight": "Freedom and intimacy find balance.",
      "action": "Break free from limiting patterns.",
      "emoji": "💕",
      "exact": false
    }
  ],
  "work": [ ... ],
  "growth": [ ... ],
  "luck": [ ... ]
}

Field Reference

| Field | Type | Description | |---|---|---| | date | string | ISO date for this reading | | totalTransits | number | Total active transits across all categories | | planet | string | Transiting planet (lowercase: sun, moon, mars, etc.) | | natal | string | Natal planet being aspected (lowercase) | | transit | string | Aspect type string e.g. "Uranus square" | | insight | string | Positive interpretation of the transit | | action | string | What to do about it today | | exact | boolean | Whether the transit is exact today (peak influence) |

Aspect Reference

Understanding aspects helps you interpret the data. Each aspect represents a geometric relationship between planets:

| Symbol | Name | Angle | Vibe | Meaning | |---|---|---|---|---| | ☌ | Conjunction | 0° | Fusion | Two forces merge — intense, focused, amplified energy | | ☍ | Opposition | 180° | Tension | Opposing forces — awareness through contrast | | □ | Square | 90° | Challenge | Friction that demands growth — a productive challenge | | △ | Trine | 120° | Harmony | Natural flow and ease — gifts arriving without effort | | ⚹ | Sextile | 60° | Opportunity | An open door — rewards conscious action | | ⚻ | Quincunx | 150° | Adjustment | Subtle misalignment requiring creative adaptation |

Planet Glyphs & Meanings

| Glyph | Planet | Governs | |---|---|---| | ☀️ | Sun | Identity, vitality, purpose | | 🌙 | Moon | Emotions, instincts, inner world | | ☿ | Mercury | Mind, communication, learning | | ♀ | Venus | Love, beauty, values, pleasure | | ♂ | Mars | Drive, action, desire, courage | | ♃ | Jupiter | Expansion, luck, wisdom, growth | | ♄ | Saturn | Structure, discipline, mastery | | ⛢ | Uranus | Revolution, freedom, sudden change | | ♆ | Neptune | Dreams, intuition, spirituality | | ♇ | Pluto | Transformation, power, rebirth |

Dashboard Integration

daily-json.js is designed for dashboard use. Here's how to integrate it:

Server-Side (Node.js)

// In your server.js API endpoint
const { execSync } = require('child_process');
const astroPath = path.join(process.env.HOME, '.openclaw', 'workspace', 'skills', 'astro-life-insights', 'daily-json.js');
const output = execSync(/opt/homebrew/bin/node daily-json.js, {
  encoding: 'utf8',
  timeout: 10000,
  cwd: path.dirname(astroPath),
  env: { ...process.env, PATH: '/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin', HOME: process.env.HOME }
});
const data = JSON.parse(output.trim());

> ⚠️ Important: Always use the full node path (/opt/homebrew/bin/node) and set PATH explicitly in env. launchd/daemon environments often don't inherit shell PATH.

Educational Visualization

When building a UI, display transits with:

This turns a transit like "Uranus square natal Mars" into something anyone can understand and learn from, not just astrologers.

How It Works

1. Calculate Transits - Uses astronomy-engine to find current planetary positions 2. Compare to Natal Chart - Identifies aspects (conjunctions, trines, squares, etc.) 3. Map to Life Areas - Venus/Mars/7th house = relationships, Sun/Saturn/10th = work, etc. 4. Positive Interpretation - Frames every transit as opportunity 5. Actionable Advice - Tells you what to DO about it

Files

Why This is Different

Other astrology tools:

This tool:

Privacy & Your Data

Your natal chart is stored locally on your machine at:

~/.config/astro-life-insights/natal-chart.json

This file is outside the skill folder and is never packaged or published. This skill ships with zero personal data — every user must run configure.js to enter their own birth details before anything works.

Nothing is sent to external services. All calculations happen locally using the astronomy-engine npm package.

Requirements

Changelog

v1.1.0

v1.0.0

Built with intention 🌀

Get Today's Insights (Human-Readable)

node daily.js

Output:

✨ Your Astrological Weather - March 13, 2026
💕 RELATIONSHIPS
Uranus square natal Mars (building)
→ Freedom and intimacy find balance.
→ Action: Break free from limiting patterns.
💼 WORK
Sun square natal Uranus (EXACT TODAY)
→ Building identity through productive challenge.
→ Action: Honor both your needs and commitments.
🌱 PERSONAL GROWTH
Neptune sextile natal Moon (building)
→ Intuition guides evolutionary path.
→ Action: Tune into subtle guidance.
🍀 LUCK
Venus square natal Neptune (building)
→ Fortune through clarifying values.
→ Action: Invest in what you truly value.
✨ OVERALL: 15 active transits today. Rich day for inner work.

Get Insights for Specific Date

node daily.js 2026-03-15

Check Upcoming Transits

node upcoming.js

Shows major transits coming in the next 30 days.

Get JSON Output (for dashboards and automation)

node daily-json.js

Returns structured JSON — perfect for integrating into dashboards, agents, or any app.