configure

Save your API key locally so you don't have to pass it every time.

avg configure --key avg_xxxxxxxxxxxxxxxxxxxx
avg configure --show   # print current config

Flag	Description
-k, --key <key>	Your developer API key
--api-url <url>	Custom API base URL
--show	Print the current saved configuration

---

profiles list

List all birth profiles on your account.

avg profiles list

---

profiles create

Create a new birth profile.

avg profiles create \
  -n "Arjun Sharma" \
  -g male \
  -d 1990-06-15 \
  -t 06:30 \
  -z Asia/Kathmandu \
  -l "Kathmandu, Nepal" \
  --lat 27.7172 --lon 85.3240

Flag	Description
-n, --name <name>	Full name
-g, --gender <gender>	male or female
-d, --date <date>	Birth date YYYY-MM-DD (AD/Gregorian)
-t, --time <time>	Birth time HH:mm (24-hour)
-z, --timezone <tz>	IANA timezone, e.g. Asia/Kathmandu
-l, --location <loc>	Location name (for display)
--lat <lat>	Latitude (decimal degrees)
--lon <lon>	Longitude (decimal degrees)
--notes <notes>	Optional notes

---

chart full

Full birth chart — planets, houses, and ascendant.

avg chart full <profileId>
avg chart full <profileId> --json   # raw JSON output

---

chart details

Key details — ascendant, moon sign, sun sign, nakshatra.

avg chart details <profileId>

---

rashifal

Horoscope forecast for any period.

avg rashifal <profileId>
avg rashifal <profileId> --period monthly --calendar bs
avg rashifal <profileId> --period daily --locale ne

Flag	Description
-p, --period <period>	daily · weekly · monthly · yearly (default: monthly)
-c, --calendar <cal>	ad (Gregorian) · bs (Bikram Sambat, default: ad)
-l, --locale <locale>	en · hi · ne (default: en)
--json	Raw JSON output

---

keys list

Show all API keys and current credit balance.

avg keys list

---

keys create

Create a new API key. The full key is shown once — save it immediately.

avg keys create "My App"

---

keys revoke

Permanently revoke an API key.

avg keys revoke <keyId>

---

Global flags

Flag	Description
--json	Output raw JSON (supported on most read commands)
--version	Print CLI version
--help	Show help for any command

---

JSON output

All read commands accept --json for scripting:

# Extract all planet signs with jq
avg chart full <profileId> --json | jq '[.planets[] | {planet, sign, house}]'

# Get current rashifal score
avg rashifal <profileId> --json | jq '.overallScore'