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:

• 💕 Relationships - Love, connection, partnerships
• 💼 Work - Career, achievement, projects
• 🌱 Personal Growth - Learning, spirituality, transformation
• 🍀 Luck - Opportunities, abundance, manifestation

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:

• Birth date (YYYY-MM-DD)
• Birth time (HH:MM in 24-hour format)
• Birth location (city, country)

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

Aspect Reference

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

Planet Glyphs & Meanings

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:

• Planet chip: glyph + planet name (hoverable with meaning)
• Aspect symbol: colored by vibe (square=purple, trine=indigo, etc.)
• Natal chip: what in your natal chart is being activated
• "EXACT TODAY" badge: pulsing highlight when exact: true
• Aspect description: what the aspect type means geometrically
• Insight: the positive interpretation
• Action: concrete thing to do today
• Planet meanings: educational footer so users learn over time

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

• configure.js — One-time setup for your natal chart
• daily.js — Human-readable daily insights
• daily-json.js — Machine-readable JSON output for dashboards/automation
• upcoming.js — See future transits
• calculate.js — astronomy-engine wrapper
• interpret.js — Transit → insight mapping
• data/interpretations.json — Database of positive meanings
• data/life-areas.json — Life area → planet/house mapping

Why This is Different

Other astrology tools:

• Generic sun sign horoscopes (not personalized)
• Focus on negative/challenging aspects
• No actionable advice
• Not tailored to YOUR life

This tool:

• Uses YOUR exact natal chart
• Everything framed positively
• Focused on relationships, work, growth, luck
• Tells you what to DO, not just what to expect
• JSON output ready for dashboard integration

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

• Node.js 16+
• astronomy-engine npm package (run npm install in the skill directory)

Changelog

v1.1.0

• Documented daily-json.js JSON output format and full field schema
• Added Aspect Reference table (symbols, angles, meanings)
• Added Planet Glyphs reference
• Added Dashboard Integration guide with server-side code and educational visualization patterns
• Added note on PATH requirement for daemon/launchd environments

v1.0.0

• Initial release

Built with intention 🌀