Skip to content

Command line

Sanam edited this page Oct 7, 2026 · 1 revision

The jharicast command assesses a route, compares alerts, or checks the sources. Until it is published, run it from a clone:

dotnet run --project tools/Jharicast.Cli -c Release -- route --from Birtamod --to Lumbini --date 2026-09-28 --contact ops@example.org
Command What it prints
route --from <place> --to <place> [--via <place>] --date <yyyy-MM-dd> [--days N] [--json] One row per leg and day: km and hill km, rain and gust maxima per model, and the flag; then each rule's reason, the districts crossed and their DHM levels, data times and source health.
alerts --date <yyyy-MM-dd> [--days N] [--json] The ensemble rain level against DHM's, by province and day, and how often they agree.
sources check Each source fetched once, with its health.

A place is a town in the gazetteer (every district headquarters, plus towns such as Birtamod, Butwal and Lumbini) or latitude,longitude. No geocoding service is called.

The contact mailbox

Live requests carry Jharicast/<version> (+https://github.com/sanamhub/jharicast; <contact>), so a site owner can reach whoever runs the command. Pass --contact <mailbox> or set JHARICAST_CONTACT. There is no default; without one nothing is sent. Use a project or team mailbox, not a personal address.

Options

Option Effect
--fixtures <dir> Answers every request from <host>/<path>.json files; never opens a socket
--now <time> The clock for a replay
--disable-host <host> Never requests that host
--osrm <url> Your own OSRM server. The default is the public demo server, for light personal use only
--snapshots <dir> Where fetched snapshots are kept

Exit codes

Code Means
0 Done
1 sources check found an official source failing or drifting
2 The command could not run, for example the router or Open-Meteo was refused

Clone this wiki locally