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
CODEBLOCK0
2. Configure Your Birth Chart
CODEBLOCK1
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 INLINECODE0
2. Test It
CODEBLOCK2
Should output your personalized insights for today!
Usage
Get Today's Insights (Human-Readable)
CODEBLOCK3
Output:
CODEBLOCK4
Get Insights for Specific Date
CODEBLOCK5
Check Upcoming Transits
CODEBLOCK6
Shows major transits coming in the next 30 days.
Get JSON Output (for dashboards and automation)
CODEBLOCK7
Returns structured JSON — perfect for integrating into dashboards, agents, or any app.
JSON Output Schema (daily-json.js)
CODEBLOCK8
Field Reference
| Field | Type | Description |
|---|
| INLINECODE2 | string | ISO date for this reading |
| INLINECODE3 |
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
INLINECODE14 is designed for dashboard use. Here's how to integrate it:
Server-Side (Node.js)
CODEBLOCK9
⚠️ 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 INLINECODE18
- 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
- Compare to Natal Chart - Identifies aspects (conjunctions, trines, squares, etc.)
- Map to Life Areas - Venus/Mars/7th house = relationships, Sun/Saturn/10th = work, etc.
- Positive Interpretation - Frames every transit as opportunity
- Actionable Advice - Tells you what to DO about it
Files
- -
configure.js — One-time setup for your natal chart - INLINECODE21 — Human-readable daily insights
- INLINECODE22 — Machine-readable JSON output for dashboards/automation
- INLINECODE23 — See future transits
- INLINECODE24 — astronomy-engine wrapper
- INLINECODE25 — Transit → insight mapping
- INLINECODE26 — Database of positive meanings
- INLINECODE27 — 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:
CODEBLOCK10
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+
- INLINECODE30 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
Built with intention 🌀星象生活洞察 ✨
为您量身定制的每日星座运势，以积极视角呈现。
功能说明
根据您个人星盘计算当前行星行运，并提供以下领域的洞察：
- - 💕 人际关系 - 爱情、联结、伴侣关系
- 💼 工作事业 - 职业、成就、项目进展
- 🌱 个人成长 - 学习、灵性、蜕变
- 🍀 幸运机遇 - 机会、丰盛、显化
一切以积极视角呈现。 挑战性行运转化为成长契机。土星四分相 = 奠定基础。火星对分相 = 引导激情。
初始设置（一次性，必需）
⚠️ 本技能不附带任何个人数据。 使用前必须运行设置程序。您的出生数据仅保存在本地设备。
1. 安装依赖
bash
cd path/to/astro-life-insights
npm install
2. 配置您的出生星盘
bash
node configure.js
系统将提示您输入：
- - 出生日期（YYYY-MM-DD）
- 出生时间（HH:MM，24小时制）
- 出生地点（城市，国家）
数据将保存至 ~/.config/astro-life-insights/natal-chart.json
2. 测试运行
bash
node daily.js
应输出您今日的个性化洞察！
使用方法
获取今日洞察（人类可读格式）
bash
node daily.js
输出示例：
✨ 您的星象天气 - 2026年3月13日
💕 人际关系
天王星四分本命火星（形成中）
→ 自由与亲密找到平衡。
→ 行动：打破限制性模式。
💼 工作事业
太阳四分本命天王星（今日精准）
→ 通过建设性挑战塑造身份。
→ 行动：尊重自身需求与承诺。
🌱 个人成长
海王星六分本命月亮（形成中）
→ 直觉指引进化之路。
→ 行动：倾听微妙的指引。
🍀 幸运机遇
金星四分本命海王星（形成中）
→ 通过厘清价值观获得好运。
→ 行动：投资于您真正珍视的事物。
✨ 总体：今日15个活跃行运。适合内在工作的丰富一天。
获取指定日期洞察
bash
node daily.js 2026-03-15
查看未来行运
bash
node upcoming.js
显示未来30天内的主要行运。
获取JSON输出（适用于仪表盘和自动化）
bash
node daily-json.js
返回结构化JSON数据——完美适配仪表盘、智能体或任何应用。
JSON输出架构（daily-json.js）
json
{
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: [ ... ]
}
字段说明
| 字段 | 类型 | 描述 |
|---|
| date | 字符串 | 本次解读的ISO日期 |
| totalTransits |
数字 | 所有类别的活跃行运总数 |
| planet | 字符串 | 行运行星（小写：sun、moon、mars等） |
| natal | 字符串 | 被影响的本命行星（小写） |
| transit | 字符串 | 相位类型字符串，例如Uranus square |
| insight | 字符串 | 行运的积极解读 |
| action | 字符串 | 今日应对建议 |
| exact | 布尔值 | 行运是否今日精准（影响力峰值） |
相位参考
理解相位有助于解读数据。每个相位代表行星间的几何关系：
| 符号 | 名称 | 角度 | 能量 | 含义 |
|---|
| ☌ | 合相 | 0° | 融合 | 两股力量合并——强烈、专注、放大的能量 |
| ☍ |
对分相 | 180° | 张力 | 对立力量——通过对比获得觉知 |
| □ | 四分相 | 90° | 挑战 | 要求成长的摩擦——建设性挑战 |
| △ | 三分相 | 120° | 和谐 | 自然流动与轻松——不费力的礼物 |
| ⚹ | 六分相 | 60° | 机遇 | 敞开的门——回报有意识的行动 |
| ⚻ | 补八分相 | 150° | 调整 | 需要创造性适应的微妙错位 |
行星符号与含义
月亮 | 情绪、本能、内心世界 |
| ☿ | 水星 | 思维、沟通、学习 |
| ♀ | 金星 | 爱情、美感、价值观、愉悦 |
| ♂ | 火星 | 驱动力、行动、欲望、勇气 |
| ♃ | 木星 | 扩张、幸运、智慧、成长 |
| ♄ | 土星 | 结构、纪律、精通 |
| ⛢ | 天王星 | 革命、自由、突然变化 |
| ♆ | 海王星 | 梦想、直觉、灵性 |
| ♇ | 冥王星 | 蜕变、力量、重生 |
仪表盘集成
daily-json.js专为仪表盘使用设计。集成方法如下：
服务端（Node.js）
js
// 在您的server.js API端点中
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());
⚠️ 重要提示：始终使用完整的node路径（/opt/homebrew/bin/node）并在env中显式设置PATH。launchd/守护进程环境通常不继承shell的PATH。
教育性可视化
构建UI时，按以下方式展示行运：
- - 行星标签：符号 + 行星名称（可悬停显示含义）
- 相位符号：按能量着色（四分相=紫色，三分相=靛蓝等）
- 本命标签：本命星盘中正在被激活的部分
- 今日精准徽章：当exact: true时脉冲高亮
- 相位描述：相位类型的几何含义
- 洞察：积极解读
- 行动建议：今日具体可做的事
- 行星含义：教育性页脚，让用户随时间学习
这将把Uranus square natal Mars这样的行运转化为任何人都能理解和学习的内容，而不仅仅是占星师。
工作原理
- 1. 计算行运 - 使用天文引擎计算当前行星位置
- 对比本命星盘 - 识别相位（合相、三分相、四分相等）
- 映射至生活领域 - 金星/火星/第七宫=人际关系，太阳/土星/第十宫=工作等
- 积极解读 - 将每个行运视为机遇
- 可操作建议 - 告诉您该怎么做
文件说明
- - configure.js — 一次性设置本命星盘
- daily.js — 人类可读的每日洞察
- daily-json.js — 机器可读的JSON输出（适用于仪表盘/自动化）
- upcoming.js — 查看未来行运
- calculate.js — 天文引擎封装
- interpret.js — 行运→洞察映射
- data/interpretations.json — 积极含义数据库
- data/life-areas.json — 生活领域→行星/宫位映射
独特之处
其他占星工具：
- - 通用的太阳星座运势（非个性化）
- 聚焦负面/挑战性相位
- 无可操作建议
- 不针对您的个人生活
本工具：
- - 使用您精确的本命星盘
- 一切以积极视角呈现
- 聚焦人际关系、工作、成长、幸运
- 告诉
