CLI

The gitstrology command-line tool lets you generate charts and readings from your terminal with no code.

Install

npm install -g gitstrology
# or run one-off with npx
npx gitstrology --help

Authentication

export GITSTROLOGY_API_KEY="gs_live_..."

Commands

Command	Description
`chart`	Generate a natal chart.
`horoscope`	Daily horoscope for a sign.
`compat`	Compatibility between two people.

Examples

# Natal chart
npx gitstrology chart --birth 1990-03-15 --time 14:30 --lat 44.8 --lon 20.4

# Daily horoscope
npx gitstrology horoscope --sign aries

# Compatibility
npx gitstrology compat \
  --person1 "1990-03-15,14:30,44.8,20.4" \
  --person2 "1988-07-22,09:00,40.7,-74.0"

Global flags

Flag	Description
`--json`	Output raw JSON instead of formatted text.
`--api-key <key>`	Override `GITSTROLOGY_API_KEY`.

See the SDK docs for programmatic usage, or the quickstart for an overview.