jyotish-cli

Terminal-first CLI for jyotish-calc with two operating styles:

• Human mode: readable output with branded ASCII banner.
• AI mode: strict JSON payloads for agent pipelines.

Features

• Full feature coverage through dynamic invocation of exported functions.
• Discoverability commands (modules, functions).
• Generic executor command for any API target (invoke / run).
• AI-safe execution command (agent) with JSON request/response contracts.
• Diagnostics command (doctor) for environment sanity checks.

Install (local workspace)

cd jyotish-cli
npm install

Run directly:

node ./bin/jyotish.js --help

Or globally in your machine:

npm link
jyotish --help

Command Overview

jyotish start --date 2020-05-05 --time 15:05:05 --lat 25 --lng 70 --timezone 5
jyotish start
jyotish panchanga --date 2020-05-05 --time 15:05:05 --lat 25 --lng 70 --timezone 5
jyotish chart --date 2020-05-05 --time 15:05:05 --lat 25 --lng 70 --timezone 5
jyotish doshas --date 2020-05-05 --time 15:05:05 --lat 25 --lng 70 --timezone 5
jyotish yogas --date 2020-05-05 --time 15:05:05 --lat 25 --lng 70 --timezone 5
jyotish dashas --date 2020-05-05 --time 15:05:05 --lat 25 --lng 70 --timezone 5
jyotish modules
jyotish functions --module panchanga
jyotish invoke <target> --args-file ./examples/args.json
jyotish --mode ai invoke <target> --args-file ./examples/args.json
jyotish agent --request-file ./examples/request.json
jyotish doctor

Human usage examples

Run full workflow (everything):

jyotish start --date 2020-05-05 --time 15:05:05 --lat 25 --lng 70 --timezone 5

Interactive UX mode (prompts for birth input + sections):

jyotish start

List all top-level modules:

jyotish modules

List callable functions for a module:

jyotish functions --module vargas

Invoke a function using argument file:

jyotish invoke panchanga.calculatePanchanga --args-file ./examples/panchanga-args.json

AI usage examples

Invoke with strict JSON output:

jyotish --mode ai invoke panchanga.quickTithi --args-file ./examples/quick-tithi-args.json

Agent request contract:

{
  "target": "vargas.calculateVarga",
  "args": [45.5, "D9"]
}

Run agent request:

jyotish agent --request-file ./examples/agent-request.json

Response contract:

{
  "ok": true,
  "schema_version": "1.0.0",
  "target": "vargas.calculateVarga",
  "duration_ms": 3,
  "result": {}
}

Error contract:

{
  "ok": false,
  "schema_version": "1.0.0",
  "target": "vargas.invalidFunction",
  "error": {
    "code": "UNKNOWN_TARGET",
    "message": "Unknown target segment \"invalidFunction\" in \"vargas.invalidFunction\""
  }
}

Error codes used by AI mode:

• INVALID_ARGS: bad request shape, malformed JSON, or conflicting flags.
• UNKNOWN_TARGET: unknown function path or non-callable target.
• RUNTIME_ERROR: target function threw during execution.

High-value targets

• grahas.getGrahasPosition
• panchanga.calculatePanchanga
• dashas.calculateAllPlanetaryDashas
• dashas.getAllActiveDashas
• vargas.calculateVarga
• vargas.calculateVargaChart
• strengths.calculateShadbala
• strengths.calculateBhavaBala
• lagnas.calculateAllSpecialLagnas
• upagrahas.calculateAllUpagrahas
• ashtakavarga.calculateAshtakavarga
• doshas.getDoshaDetails
• rajayogas.getRajaYogaDetails
• yogas.getYogaDetails