Quran Turn
FOR CLAUDE CODE & CODEX · OPEN SOURCE

Read Qur’an
while your agent thinks.

Send a prompt and a quiet reader opens at the exact ayah you left. When your agent needs you, it steps aside. When the turn ends, your place is saved.

Works with Claude Code Codex

Free. Open source. No account. No tracking.

QURAN TURNClaude is working
البقرة
AL-BAQARA · 2:155

وَلَنَبْلُوَنَّكُم بِشَىْءٍ مِّنَ ٱلْخَوْفِ وَٱلْجُوعِ وَنَقْصٍ مِّنَ ٱلْأَمْوَٰلِ وَٱلْأَنفُسِ وَٱلثَّمَرَٰتِ ۗ وَبَشِّرِ ٱلصَّـٰبِرِينَ

3 ayat this turnTanzil ✓

Install: let your agent do it

Claude Code

Paste this into Claude Code (terminal, or the Code tab in the Claude desktop app):

Install the Quran Turn plugin for me. In the terminal, run claude plugin marketplace add rzrizaldy/quran-turn and then claude plugin install quran-turn@quran-turn. When both succeed, tell me to restart Claude Code. If the claude command isn't available, tell me to type /plugin marketplace add rzrizaldy/quran-turn and then /plugin install quran-turn@quran-turn myself, one line at a time.
Or run the commands yourself
  1. /plugin marketplace add rzrizaldy/quran-turn
  2. /plugin install quran-turn@quran-turn

Type each line into Claude Code on its own, one at a time.

Codex

Paste this into Codex (CLI or the Codex app):

Install the Quran Turn plugin for me. In the terminal, run codex plugin marketplace add rzrizaldy/quran-turn and then codex plugin add quran-turn@quran-turn. When both succeed, tell me to restart Codex and approve Quran Turn's hooks when it asks.
Or run the commands yourself
  1. codex plugin marketplace add rzrizaldy/quran-turn
  2. codex plugin add quran-turn@quran-turn

Run each line in your terminal, then start codex and approve Quran Turn’s hooks once.

Needs Node.js 18+. No dependencies, no account.

01 · PROMPT

You hand off a task

The reader opens where you stopped, the moment you send a prompt.

02 · READ

Your agent works

Read at your pace. Every ayah you move is saved locally, instantly.

03 · NEEDS YOU

It asks permission

The reader pauses and points you back to the terminal.

04 · DONE

The turn ends

Your place is kept. One line records the ayat you read, nothing more.

Exact text, never touched

Tanzil’s verified Uthmani text ships byte-for-byte and is checked by SHA-256 before it renders. No model ever writes a letter of it.

Fully offline

Text, fonts and reader live on your machine. Turn off Wi-Fi and it keeps working.

Yours, in plain files

Your position and reading log are small JSON files in ~/.quran-turn. No account, no sync, no analytics.