Relationship Intelligence Agent

A cross-platform AI-agent Skill and Python engine for evidence-led natal and relationship astrology. One shared calculation core supports Codex, Claude Code, Cursor, Cline, Windsurf, and any agent that can run a JSON CLI.

The plugin validates birth data, resolves optional place names and historical UTC offsets, calculates planetary longitudes with Swiss Ephemeris, finds natal and synastry aspects, and builds midpoint composite, Davison, and separate person-A/person-B Marks charts. Explicit coordinates and offsets always take precedence over automatic lookup.

python3 -m pip install -r requirements.txt
python3 -m app.main
python3 -m pytest -q

Codex

Link the skill into your personal Codex skills directory:

ln -sfn "$PWD/skills/relationship-intelligence" ~/.codex/skills/relationship-intelligence

Restart Codex, then invoke $relationship-intelligence.

Claude Code

Install directly from the public GitHub marketplace:

/plugin marketplace add mxbao063-bao/relationship-intelligence-agent
/plugin install relationship-intelligence-agent@michelle-relationship-tools
/reload-plugins

Invoke the skill with:

/relationship-intelligence-agent:relationship-intelligence

For local development, run claude --plugin-dir . from the repository root.

Generic CLI

Shell agents and other platforms can call the JSON CLIs directly:

python3 skills/relationship-intelligence/scripts/analyze_natal.py person.json --pretty
python3 skills/relationship-intelligence/scripts/analyze_relationship.py input.json --pretty

Cursor

The repository includes an agent-requested project rule at .cursor/rules/relationship-intelligence.mdc. Open this repository as the Cursor workspace and ask:

Use the relationship-intelligence rule to calculate a natal chart for
1992-02-26 at 07:00 in Hangzhou, China.

You can also select @relationship-intelligence from Cursor's rule picker.

Cline

Cline automatically discovers .cline/skills/relationship-intelligence. Invoke it with /relationship-intelligence while this repository is the primary workspace.

For global use on macOS or Linux, link the canonical skill:

mkdir -p ~/.cline/skills
ln -sfn "$PWD/skills/relationship-intelligence" ~/.cline/skills/relationship-intelligence

Windsurf

Windsurf automatically discovers .windsurf/skills/relationship-intelligence. Invoke it with @relationship-intelligence while this repository is open.

For global use on macOS or Linux, link the canonical skill:

mkdir -p ~/.codeium/windsurf/skills
ln -sfn "$PWD/skills/relationship-intelligence" ~/.codeium/windsurf/skills/relationship-intelligence

License

Copyright © 2026 Michelle.

This project is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later). You may use, modify, distribute, and use it commercially under the license terms. Modified versions offered to users over a network must provide the corresponding source as required by AGPL section 13.

The calculation engine depends on AGPL-licensed PySwissEph and Swiss Ephemeris. Swiss Ephemeris also offers a separate professional license. See THIRD_PARTY_NOTICES.md before redistributing the project or building a closed-source commercial product.