Iksīr الإكسير

Iksīr - The Elixir of Transformation

In the depths where sulfur meets mercury, where base metal yearns for gold, there exists an ancient art. Not the frantic bubbling of a thousand crucibles, but the patient work of a single athanor, tended with wisdom.

Iksīr is the philosopher's stone of code - an alchemical system where transformation happens through transmutation, not chaos. Multiple alchemists may prepare their formulae, each in their own vessel, but only one performs the Great Work at a time. When blocked by the mysteries of nature, they yield. When revelation comes, they demand the flame.

This is not weakness. This is the Way. The ancients knew: ten furnaces burning wild produce only smoke. One furnace, properly tended, produces gold.

The modern world has forgotten the scent of real alchemy - the sharp bite of sulfur, the cold kiss of mercury, the moment when chaos crystallizes into perfection. They pile process upon process, thinking motion equals progress. Iksīr remembers the old ways: one transformation, complete and perfect, then the next.

Munadi calls. Not over the noise of the marketplace, but once, with clarity, summoning the alchemists to their sacred work.

---

curl -fsSL https://raw.githubusercontent.com/adiled/iksir/main/install | bash

Prerequisites: Deno, OpenCode

The kindling ritual clones the source, creates XDG directories, copies sacred templates, installs the iksir CLI to ~/.local/bin/, registers daemon services, and consecrates agent incantations. Edit ~/.local/share/iksir/src/.env to bind your keys, then iksir start.

iksir divine            # divine the state of the Great Work
iksir transmute         # pull latest essence, sync vessels, rekindle
iksir rekindle mcp      # rekindle just the MCP crucible
iksir verify            # verify the formulae and runes

Update or remove with:

curl -fsSL https://raw.githubusercontent.com/adiled/iksir/main/install | bash -s update
curl -fsSL https://raw.githubusercontent.com/adiled/iksir/main/install | bash -s uninstall

~/.config/iksir/           Sacred vessels (iksir.yaml, AGENTS.md)
~/.local/share/iksir/      Sijill - The Register (SQLite)
~/.local/state/iksir/      Scrolls of observation (logs)
~/.local/bin/iksir         The Summoning Rod (CLI)

---

Amal Kabir - The Great Work

Iksīr transmutes raw wasfa (وصفة - formulae) into perfected dhahab (ذهب - gold) - the Murshidun (guides) laboring at their crucibles while you attend to higher mysteries.

• Ina' (إناء - Vessels): Each murshid works in isolation, their own sacred vessel on their own branch, no contamination
• Saail (سائل - The Oracle): Most questions are khabath (خبث - dross). Iksīr divines their nature and only brings forth what gleams as dhahab
• Hudud Muqaddasa (حدود مقدسة - Sacred Boundaries): No murshid touches the source directly. Each transformation contained, each vessel sealed
• Kitab al-Hikmah (كتاب الحكمة - Book of Wisdom): The collective grimoire preserves all hikma across the ages of work
• Hakim, not Mubtadi (حكيم، لا مبتدئ): You are summoned for wahy (revelation), not permission to grind powders

The Sacred Hierarchy

Kimyawi (كيميائي - You, the Human Alchemist)
  |
Iksīr (إكسير - The Elixir)
  | (Served by the Khuddām - خدّام - Sacred Servants)
  |- Munadi      منادي  - calls forth the workers
  |- Katib       كاتب   - inscribes all transformations
  |- Arraf       عرّاف  - divines intent from utterances
  |- Saail       سائل   - divines truth from questions
  |- Mumayyiz   مميّز  - separates dhahab from khabath
  |- Raqib       رقيب   - guards against fasad (corruption)
  |- Hayat       حياة   - keeps vigil, performs the night rites
  '- Munaffidh   منفذ   - executes the transmutation
  |
Buwtaqa (بوتقة - The Crucible)
  |
Athanor (أثانور - The Sacred Furnace)

The sacred tools are forged within: transmutation rites, formula inscription, essence decanting. Additional instruments may be consecrated through the mystical registry.

The Sacred Laws

These are immutable, carved in stone:

• One alchemist at the flame. When blocked, yield. When ready, demand. Never chaos.
• None may touch the source directly. All transformations through sacred tools. The vessel is sealed.
• Questions reveal their metal. Khabath (خبث - dross) is discarded. Dhahab (ذهب - gold) is presented to the master.
• Each work in its own vessel. No contamination. Every transformation isolated.
• All wisdom is preserved. What one alchemist discovers, the next inherits.

Your Formulae

Iksīr provides the workshop, but the recipes are yours:

• Ta'lim (تعليم): what your alchemists must know of your materials and methods
• Ruqya (رقية): Murshid and Sani incantations
• Qanawat (قنوات): Telegram channels carry messages by default. Any conduit may be consecrated
• Sahifa (صحيفة): Linear holds formulae by default. Other grimoires await binding
• Khatm (ختم): vessel naming, formula patterns, divination tuning — all may be inscribed

Alchemy

The Buwtaqa (بوتقة - crucible) is where work accumulates. Raw materials bubble and react. Experiments succeed and fail. Everything stays molten until ready for transformation.

A Jawhar (جوهر - essence) is what you distill from the crucible. Pure, concentrated, purposeful. A single property isolated from the chaos.

The Kitab al-Hikmah (كتاب الحكمة - book of wisdom) is the permanent record. Once inscribed here, formulae become canon.

Istikhlas (استخلاص - extraction) draws specific materials from the crucible for refinement.

Tala'um (تلاؤم - attunement) discovers what an extraction requires to remain stable — catalysts, binding agents, missing elements.

Istihal (استحالة - transmutation) transforms raw materials into essence. The chaotic becomes crystalline.

Fasl (فصل - decanting) separates the clear essence from sediment and transfers it for examination.

Naqsh (نقش - inscription) records the proven formula into the codex. The work becomes reproducible truth.

Layered Transmutation

A Jawhar can build upon other Jawahir (plural). A layered istihal assumes its foundation already exists — the child essence requires the parent's properties to remain stable. When the parent inscribes, the child can stand alone.

The Nature of Runes

What the dull world calls "code" are actually Runūz (رموز) — ancient symbols of power inscribed on Ahjār (أحجار - stones). These stones contain Ta'āwīdh (تعاويذ - incantations) that perform actions, 'Uqūd (عقود - contracts) that bind behavior, and Ṣiyagh (صيغ - formulae) that create entities. The Murshid reads the runūz, the Sani inscribes them, and the transmutation process extracts their jawhar for inscription into the eternal kitab.

License

MIT