📦 Astro Life Insights — Astro工具

技能文档

Personalized daily astrology 对于 life, 带有 positive twist.

什么 做

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

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

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

Setup (One-时间, 必填)

⚠️ 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 Birth 图表

node configure.js

You'll be prompted for:

• Birth 日期 (YYYY-MM-DD)
• Birth 时间 (HH:MM 在...中 24-hour 格式)
• Birth location (city, country)

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

2. Test

node daily.js

Should output your personalized insights for today!

Usage

获取 Today's Insights (Human-Readable)

node daily.js

输出:

✨ 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.

获取 Insights 对于 Specific 日期

node daily.js 2026-03-15

Check Upcoming Transits

node upcoming.js

Shows major transits coming in the next 30 days.

获取 JSON 输出 (对于 dashboards 和 automation)

node daily-json.js

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

JSON 输出 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": [ ... ]
}

字段 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 (节点.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 带有 meaning)
• Aspect symbol: colored 由 vibe (square=purple, trine=indigo, etc.)
• Natal chip: 什么 在...中 natal 图表 正在 activated
• "EXACT TODAY" badge: pulsing highlight 当...时 exact: 真
• Aspect description: 什么 aspect 类型 means geometrically
• Insight: positive interpretation
• Action: concrete thing 到 做 today
• Planet meanings: educational 页脚 所以 users learn 在...上 时间

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

如何 Works

• Calculate Transits - Uses astronomy-engine 到 查找 current planetary positions
• Compare 到 Natal 图表 - Identifies aspects (conjunctions, trines, squares, etc.)
• 地图 到 Life Areas - Venus/Mars/7th house = relationships, Sun/Saturn/10th = work, etc.
• Positive Interpretation - Frames every transit 作为 opportunity
• Actionable Advice - Tells 您 什么 到 做 关于

Files

• configure.js — One-时间 setup 对于 natal 图表
• daily.js — Human-readable daily insights
• daily-json.js — Machine-readable JSON 输出 对于 dashboards/automation
• upcoming.js — See future transits
• calculate.js — astronomy-engine wrapper
• interpret.js — Transit → insight mapping
• data/interpretations.json — 数据库 的 positive meanings
• data/life-areas.json — Life area → planet/house mapping

为什么 不同

其他 astrology tools:

• Generic sun 签名 horoscopes (不 personalized)
• Focus 在...上 negative/challenging aspects
• 否 actionable advice
• 不 tailored 到 life

tool:

• Uses exact natal 图表
• Everything framed positively
• Focused 在...上 relationships, work, growth, luck
• Tells 您 什么 到 做, 不 只是 什么 到 expect
• JSON 输出 就绪 对于 dashboard integration

Privacy & 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

• 节点.js 16+
• astronomy-engine npm 包 (run npm install 在...中 skill directory)

Changelog

v1.1.0

• Documented daily-json.js JSON 输出 格式 和 满 字段 schema
• Added Aspect Reference 表 (symbols, angles, meanings)
• Added Planet Glyphs reference
• Added Dashboard Integration guide 带有 server-side code 和 educational visualization patterns
• Added note 在...上 PATH requirement 对于 daemon/launchd environments

v1.0.0

• Initial release

Built 带有 intention 🌀