// the find
ahmadawais/ramadan-cli
CLI to check Sehar and Iftar times in Ramadan anywhere in the world.
A TypeScript CLI that prints Sehar and Iftar prayer times for Ramadan, with auto location detection, timezone/method/school recommendation, and a few output modes (table, plain, JSON, single-line status) aimed at both humans and other CLI tools or agents. It's for Muslim developers who want prayer times in their terminal instead of an app or website.
The I/O contract is unusually disciplined for a small CLI — documented exit codes, a structured `{ok:false,error:{code,message}}` JSON error shape on stderr, and a `--status` mode clearly built for status bars and other programs to consume. It has real test coverage (api, config, geo/recommendations, setup) rather than just a README. Config precedence (one-off city arg vs saved config vs IP fallback) is spelled out explicitly instead of left as implicit behavior you have to read source to figure out.
Single point of failure on the Aladhan API with no offline/cached fallback mentioned anywhere — if that service is down or rate-limits you, the tool just fails, and there's no retry or local calculation path documented. IP-based geolocation as a silent fallback is a real privacy wrinkle for a CLI that's otherwise local-first, and it's not flagged as opt-in. It's a seasonal, single-purpose tool — 11 months of the year this does nothing, which is fine for what it is but worth knowing before adopting it as a dependency in anything agent-driven. The README spends more space on branding (video, social follow badges, skill-package install) than on explaining the prayer-time calculation methods (`method`, `school` IDs) it asks you to configure.