ramadan-cal
v1.0.6
Published
๐ A beautiful terminal Ramadan calendar with prayer times, daily progress, and Hijri date
Maintainers
Readme
๐ ramadan-cal
A beautiful terminal Ramadan 2026 (1447 Hijri) calendar with prayer times, Eid countdown, and daily progress โ available as a CLI tool and inside Claude Code.
Install
npm install -g ramadan-calUsage
ramadan # Full display: prayer times + calendar + progress
ramadan times # Prayer times only
ramadan calendar # Calendar only
ramadan check # Check prayer times for any city
ramadan eid 2026-03-19 # Set the Eid date when announced
ramadan reset # Clear config and start freshSetup
First run auto-detects your location and asks one question โ when the moon was sighted. That's it.
Prayer times are calculated offline using the adhan library. No API calls needed after setup.
Claude Code
During installation, ramadan-cal automatically sets up a Claude Code skill. Just type ramadan inside any Claude Code session to see your Ramadan dashboard โ prayer times, calendar, and Eid countdown โ without leaving your coding flow. Zero tokens used.
If you skipped during install, run npm rebuild ramadan-cal to set it up later.
License
MIT
