RAMADANCAL

Ramadan 2026 prayer times, calendar, and Eid countdown — in Claude Code and your terminal.

npm install -g ramadan-cal
$
Claude Code

Works inside Claude Code, automatically

When you install ramadan-cal, it sets up a Claude Code skill for you. Just type ramadan in any Claude Code session to see your Ramadan 2026 dashboard — prayer times, calendar, and Eid countdown — without leaving your coding flow. No configuration needed. It just works.

Why

Ramadan, where developers already are

Developers spend hours in the terminal and in Claude Code. ramadan-cal meets you there — a single command to see today's prayer times, the Ramadan 2026 Hijri calendar, and how many days remain until Eid. No browser tabs, no app switching. Just a quick reminder of your spiritual duties during the blessed month, right where you work.

Features

Everything at a glance

Fajr, Dhuhr, Asr, Maghrib, and Isha times for your location. A visual Hijri calendar tracking the days of Ramadan 1447. Suhoor and Iftar times. An Eid al-Fitr countdown you can update when the date is officially announced. All beautifully formatted — whether you run it from your terminal or as a Claude Code slash command.

Installation

One install, two ways to use it

Install globally via npm. This gives you the ramadan CLI command and automatically sets up the Claude Code skill — so typing ramadan in Claude Code works immediately.

$ npm install -g ramadan-cal
$ ramadan
Troubleshooting

Claude Code skill not set up?

If the automatic setup didn't run during install, you can set it up manually in two steps.

Step 1 — Download the skill file

Download SKILL.md and place it at:

~/.claude/skills/ramadan/SKILL.md

Step 2 — Add to your CLAUDE.md

Add the following to ~/.claude/CLAUDE.md (create it if it doesn't exist):

<!-- ramadan-cal -->
## Ramadan CLI
When the user types "ramadan" or any command starting with "ramadan",
run it as a shell command using bash.
<!-- ramadan-cal -->
Commands

Simple commands, everything you need

ramadan Full display — times, calendar, progress
ramadan times Just prayer times
ramadan calendar Just the calendar grid
ramadan eid 2026-03-19 Set Eid date when announced
ramadan reset Clear config, start fresh
ramadan Run directly inside Claude Code