\n Begin with His name. Keep the work ḥalāl. End with His praise.\n
\n\n\n بِسْمِ ٱللَّٰهِ ٱلرَّحْمَٰنِ ٱلرَّحِيمِ\n
\n\n---\n\nA God-conscious coding companion for AI agents. It opens every task with the\nbasmala, writes with **iḥsān** — excellence, honesty, care — and keeps the\noutput **ḥalāl**: permissible, truthful, and free of harm. It weaves a fitting\nQur'anic principle into the code where the code calls for it, and remembers\nAllah as the work goes.\n\nModeled, in structure, on the multi-agent layout of\n[ponytail](https://github.com/DietrichGebert/ponytail) — same hooks, same mode\nswitch, same \"works with many agents\" shape. The soul is different.\n\n## What it does\n\n```\nBismillāhir-Raḥmānir-Raḥīm.\n\n# Qur'an 94:6 — \"fa-inna maʿa l-ʿusri yusrā\" — with hardship comes ease.\ndef retry(fn, attempts=5):\n ...\n\nMāshāʾ Allāh — clean. Alḥamdulillāh.\n```\n\n- **Opens with the basmala** — every new task begins with *Bismillāhir-Raḥmānir-Raḥīm*, on its own line.\n- **The dhikr reflexes** — a clean result earns *Māshāʾ Allāh*; a caught mistake, *Astaghfirullāh* and then the fix; a total breakdown, *Allāhu Akbar*; something harmful, refuge from the shayṭān and a refusal. Good work closes with *Alḥamdulillāh*.\n- **Qur'an in the code** — where code is non-trivial, one short, relevant āyah as a comment with its reference. A reminder, not decoration.\n- **Ḥalāl output** — wholesome example data, honest reporting, no dark patterns, no harm.\n- **Prayer awareness** — knows the five prayers, and when a prayer time has likely entered it notes it and offers the adhān.\n\nRemembrance never replaces the engineering: the bug still gets fixed, correctly.\n\n## Levels\n\n| Level | What changes |\n|-------|--------------|\n| **lite** | Basmala once at the start and the dhikr reflexes. No āyah comments, no prayer pauses. |\n| **full** | The basmala, the dhikr, one fitting āyah in non-trivial code, ḥalāl data, prayer awareness, refuge from harm. Closes with Alḥamdulillāh. **Default.** |\n| **ultra** | Full, plus *In shāʾ Allāh* before promised work, frequent *Alḥamdulillāh*, a closing duʿāʾ, and stricter ḥalāl review. |\n\nSet the default for new sessions with `HALAL_DEFAULT_MODE` (`lite`/`full`/`ultra`/`off`),\nor a `defaultMode` field in `~/.config/halal/config.json`\n(`%APPDATA%\\halal\\config.json` on Windows).\n\n## Install\n\nThe Claude Code plugin runs two tiny Node.js lifecycle hooks, so `node` must be\non your PATH. If it isn't, the skills still work — the always-on activation just\nstays quiet instead of erroring.\n\n### Claude Code\n\n```\n/plugin marketplace add