awqat-cli

أوقات (awqat) is Arabic for "times", referring to the five daily prayer times in Islam.

A terminal tool that shows prayer times for your city.

 █████╗ ██╗    ██╗ ██████╗  █████╗ ████████╗
██╔══██╗██║    ██║██╔═══██╗██╔══██╗╚══██╔══╝
███████║██║ █╗ ██║██║   ██║███████║   ██║
██╔══██║██║███╗██║██║▄▄ ██║██╔══██║   ██║
██║  ██║╚███╔███╔╝╚██████╔╝██║  ██║   ██║
╚═╝  ╚═╝ ╚══╝╚══╝  ╚══▀▀═╝ ╚═╝  ╚═╝   ╚═╝

Install

npx awqat-cli

# or install globally
npm install -g awqat-cli
awqat

Commands

awqat                                      # today's prayer times
awqat --setup                              # run the setup wizard
awqat --reset                              # clear config and re-run setup
awqat --week                               # full week of prayer times
awqat --next                               # next prayer + countdown
awqat --json                               # output as JSON
awqat --info                               # show saved configuration
awqat --city "Dubai" --country "UAE"       # one-off location override
awqat --help                               # list all options

Setup

On first run, awqat walks you through setup:

1. Detects your location via IP geolocation
2. Lets you pick a calculation method (MWL, ISNA, Moonsighting Committee, etc.)
3. Lets you pick a school of thought for Asr (Hanafi or Shafi/Maliki/Hanbali)

Config is saved locally. Run awqat --setup to change it, or awqat --reset to start over.

Calculation Methods

| ID | Method | Region | |----|--------|--------| | 3 | Muslim World League | Europe, Far East, parts of US | | 2 | ISNA | North America | | 5 | Egyptian General Authority | Africa, Syria, Lebanon, Malaysia | | 15 | Moonsighting Committee Worldwide | Global, based on moon sighting | | 4 | Umm Al-Qura University, Makkah | Arabian Peninsula | | 1 | University of Islamic Sciences, Karachi | Pakistan, Bangladesh, India, Afghanistan | | 7 | Institute of Geophysics, Tehran | Iran | | 8 | Gulf Region | Gulf countries | | 9 | Kuwait | Kuwait | | 10 | Qatar | Qatar | | 11 | Majlis Ugama Islam Singapura | Singapore | | 12 | Union des Organisations Islamiques de France | France | | 13 | Diyanet İşleri Başkanlığı | Turkey | | 14 | Spiritual Administration of Muslims of Russia | Russia |

The Moonsighting Committee method also lets you choose a shafaq (twilight type) for Isha calculation: general, ahmer (red), or abyad (white).

JSON Output

awqat --json prints structured JSON with no extra formatting:

{
  "date": "2026-02-20",
  "hijri": "3 Ramadan 1447",
  "location": { "city": "London", "country": "United Kingdom" },
  "method": "Muslim World League",
  "school": "Hanafi",
  "prayers": {
    "Fajr": "05:13",
    "Sunrise": "07:05",
    "Dhuhr": "12:14",
    "Asr": "15:32",
    "Maghrib": "17:25",
    "Isha": "19:10"
  },
  "next": {
    "prayer": "Dhuhr",
    "in": "1h 10m"
  }
}

API

Prayer times come from the Aladhan Prayer Times API. Free, no API key needed.

Tech Stack

• TypeScript, Node.js
• Commander for CLI parsing
• @clack/prompts for the setup wizard
• Figlet for ASCII art
• Picocolors for terminal colors
• Ora for spinners
• Zod for API response validation
• Conf for local config storage
• tsup for bundling

Contributing

1. Fork the repo
2. Create a branch (git checkout -b my-feature)
3. Commit your changes
4. Push and open a pull request

License

MIT