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 | bashPrerequisites: Deno, and a hum nest.
Iksīr kindles no furnace of its own. It nestles at a humd as a forager bee and prompts whatever hive you have chosen. What burns there is yours to decide — that choice was never Iksīr's to make. It asks only two things of al-Kimyawi:
- a worker bee nestled in the same nest, so there is something to prompt
- something in that nest providing
fs—humfs, or a worker that carries its own tools
A murshid without fs can contemplate the runūz but never inscribe them.
hum hive humfs install # the filesystem surface
hum hive <your-worker> install # whatever you would have think for youThe kindling ritual clones the source, creates XDG directories, copies sacred templates, installs the iksir CLI to ~/.local/bin/, registers daemon services, and consecrates the ruqan. Edit ~/.local/share/iksir/src/.env to bind your keys, then iksir start.
Iksīr can also be supervised as a bee in its own right — an Orchfile sits at the root, so hum hive ~/iksir install hands it to orchd.
iksir divine # divine the state of the Great Work
iksir transmute # pull latest essence, sync vessels, rekindle
iksir verify # verify the formulae and runesUpdate 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)
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
Kimyawi (كيميائي - You, the Human Alchemist)
|
Iksīr (إكسير - The Elixir)
|
|- Khuddām (خدّام - Sacred Servants)
| Eternal, bound to the workshop. One of each. They are Iksīr.
|
| |- 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
|
'- Murshidun (مرشدون - The Guides)
Summoned per wasfa, many, but only one at the flame. They perish
when the work is done. Iksīr does not contain them; it tends them.
Each dwells in its own inā', on its own branch, and never touches
the source directly.
|
'- Sani (صانع - The Craftsman)
Summoned by a Murshid for one waṣfa. Inscribes the runūz.
Returns to the void when the work is complete.
|
Buwtaqa (بوتقة - The Crucible)
|
Athanor (أثانور - The Sacred Furnace)
The Khuddām are Iksīr's own flesh. The Murshidun are not — they are cells burning in a nest al-Kimyawi has kindled, reached across the thrum. Iksīr summons them, guards the single flame among them, and carries their words to you; what they are made of was never Iksīr's to decide.
The Ālāt al-Iksīr (آلات الإكسير - instruments of the Elixir) are forged within: transmutation rites, formula inscription, essence decanting. They are advertised to the nest in Iksīr's own hello, and a summons returns to them by name. Additional instruments may be consecrated through the sijill.
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.
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
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.
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.
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.
MIT