claude-adhkar — أذكار

Turn Claude Code's spinner into dhikr, in real Arabic script.

While Claude works, instead of Vibing… you get a random dhikr each turn, and the tip line cycles through duaa. Hours of glancing at a spinner become hours of tasbeeh.

Quick start

git clone https://github.com/nosseralaa7-rgb/claude-adhkar.git
cd claude-adhkar
./install.sh

Restart Claude Code. Done.

If Arabic looks broken or gappy in your terminal (it probably does — here's why):

./install.sh --fonts

then restart your terminal and select Adhkar Mono in its font settings.

What you get

Spinner verbs — one of these shows while Claude works, changing every turn:

Tip line — cycles beneath the spinner during long work: tasbeeh, salawat on the Prophet ﷺ, istighfar, and duaa fit for the work itself — for ease (اللهم لا سهل إلا ما جعلته سهلا), Musa's duaa (رب اشرح لي صدري ويسر لي أمري — Quran 20:25-26), Yunus's duaa (Quran 21:87), refuge from anxiety, incapacity and laziness (Bukhari 6369), beneficial knowledge (رب زدني علماً — Quran 20:114), and more.

Prayer times (optional) — a next-prayer countdown in the Claude Code statusline, green → yellow under an hour → red under 15 minutes:

🕌 Maghrib 19:57 (in 43m)

./install.sh --prayer "Cairo,Egypt"       # city, country
./install.sh --prayer "Makkah,SA,4"       # optionally: calculation method (4 = Umm Al-Qura)

Times come from the free Aladhan API, fetched once a day and cached — zero latency on renders, works offline the rest of the day. If you already run a custom statusline, the installer won't touch it; statusline/prayer.cjs prints a single segment you can compose into your own script.

Want your own selection? Edit data/adhkar.json and re-run ./install.sh (regenerate the shaped edition with scripts/build_data.py if you edit the Arabic).

Why terminals butcher Arabic

Arabic needs three things a text renderer must do: lay text right-to-left (bidi), join letters into their contextual forms (shaping), and use a font that has the glyphs. Most terminals — Warp, iTerm2, VS Code's terminal — do none of them. They draw characters one cell at a time, left to right, in isolated form, using whatever fallback font the OS picks:

This repo fixes all three without needing the terminal to cooperate:

1. Pre-shaped text. The shaped edition stores the adhkar as Unicode presentation forms (the already-joined letter variants, U+FE70–U+FEFF) arranged in visual order. A dumb left-to-right renderer draws them and correct, connected Arabic comes out. Shaping done at build time — scripts/build_data.py via arabic-reshaper + python-bidi.

2. A terminal-grade Arabic font. Even pre-shaped text gets pulled apart when the OS falls back to a proportional font (Geeza Pro on macOS) and forces its glyphs into fixed-width cells. Kawkab Mono by Abdullah Arif was designed for exactly this — Arabic letterforms that fill and connect across monospace cells.

3. A font patch. Kawkab Mono normally needs a shaping engine to select its joined glyphs — the thing terminals don't have. scripts/build_font.py runs every presentation-form codepoint through HarfBuzz to find the joined glyph Kawkab would have picked, then maps it directly in the font's character table. The result — Adhkar Mono (fonts/) — renders connected Arabic in any terminal, no shaping engine involved. 147 presentation forms mapped, lam-alef ligatures included.

(Renamed from Kawkab Mono because the OFL license reserves the original name for its author.)

Editions

All options

./install.sh                             # shaped Arabic, replaces default verbs, sets tips
./install.sh --edition translit          # transliteration instead
./install.sh --edition logical           # normal Arabic (shaping-capable terminals)
./install.sh --mode append               # mix adhkar with Claude's default verbs
./install.sh --no-tips                   # spinner verbs only, leave the tip line alone
./install.sh --fonts                     # also install Adhkar Mono
./install.sh --prayer "Cairo,Egypt"      # next-prayer countdown in the statusline
./install.sh --uninstall                 # remove everything (settings backup kept)

How it works

Claude Code natively supports custom spinner text in ~/.claude/settings.json — no plugin, no patching:

{
  "spinnerVerbs": { "mode": "replace", "verbs": ["سبحان الله", "..."] },
  "spinnerTipsOverride": { "excludeDefault": true, "tips": ["..."] }
}

install.sh merges exactly these two keys into your settings (backing up to settings.json.bak first) and touches nothing else.

One honest limitation: Claude Code samples one spinner verb per turn — it changes with every new message, but won't rotate mid-turn. The tip line does cycle while it works, which is why the duaa live in both places.

Rebuilding

pip install arabic-reshaper python-bidi fonttools uharfbuzz
python3 scripts/build_data.py                                  # regenerate shaped edition from logical
python3 scripts/build_font.py KawkabMono-Regular.ttf fonts/    # rebuild Adhkar Mono from a Kawkab release

Related

• claude-dhikr — dhikr spinner in transliteration, with prayer times
• muslim-statusline — prayer times, hijri date and dhikr in the statusline
• awesome-claude-spinners — spinner packs of every kind

Licenses

• Scripts and data: MIT
• fonts/AdhkarMono-*.ttf: SIL OFL 1.1 — derived from Kawkab Mono © Abdullah Arif (Latin portions from Adobe Source Code Pro); renamed per the OFL's Reserved Font Name rule

اجعل شاشتك تذكر الله 🤲