Code With Quran — Development skill for Claude Code

---

Claude starts working, the ayah in your other pane moves forward, and you read a few lines instead of watching a spinner. The whole Uthmani text ships with the tool (Tanzil Project, ~1.3 MB), so the reader is instant and works offline.

                          Al-Baqarah · البقرة · The Cow · Medinan

              وَمَا خَلْفَهُمْ ۖ وَلَا يُحِيطُونَ بِشَىْءٍۢ مِّنْ عِلْمِهِۦٓ إِلَّا بِمَا شَآءَ ۚ
                        وَسِعَ كُرْسِيُّهُ ٱلسَّمَٰوَٰتِ وَٱلْأَرْضَ ۖ وَلَا يَـُٔودُهُۥ
                              حِفْظُهُمَا ۚ وَهُوَ ٱلْعَلِىُّ ٱلْعَظِيمُ ۝٢٥٥

                       █████████░░░░░░░░░░░  34.5%   2150 / 6236
                   j/k move · g goto · f follow · r reload · q quit

Quickstart

Node.js ≥ 18. No runtime dependencies.

git clone https://github.com/bahni-m/code-with-quran.git
cd code-with-quran
npm link                              # puts `code-with-quran` (and `cwq`) on your PATH

code-with-quran shell-init --append   # add the `claude --cwq` wrapper to your shell
code-with-quran install               # add the Claude Code hook
source ~/.bashrc                       # or ~/.zshrc — or open a new shell

Now start Claude through the wrapper:

claude --cwq            # the reader follows this session

Both writers back up the file they touch (`*.bak-`).

Reading it

Two readers — same text, same pointer, same keys. Pick whichever you'll a