hakodesh

Host-agnostic Python CLI and SDK. After pip install hakodesh the user book is empty. Your LLM or agents mint spells, enchantments, wards, and combos as they need them. Repeated structured workflows can be remembered and, after a configurable promotion policy, executed as deterministic procedures without another LLM pass.

PyPI name and import: hakodesh. The command you type is devra — that is the snx role: devra <spell> [args...] casts a minted spell. hakodesh is the same CLI binary.

This package does not prove SNX token savings. Measurements are recall, correctness, straight-through execution, re-entry, model turns, and host-reported context crossing.

Release

Current PyPI version is 0.2.3. pip install hakodesh installs this release. The command you type is devra.

0.2.0 and 0.2.1 were withdrawn from the index (deleted, not yanked). 0.2.0's procedure integrity did not cover approval or routing state and parameterized replay reused last-seen literals. 0.1.0 remains installable. 0.2.2 remains as the previous current. 0.2.3 is the same runtime as 0.2.2; it teaches devra (the snx role), spellbook, and first-class enchant / ward / combo.

Procedures are HMAC-authenticated with the home chain key. Arguments that vary across training traces become required slots; decide / run take --bind name=value. Unsigned 0.2.0 vN.json files fail closed until re-promoted.

Install

pip install hakodesh
devra hello

Data home: HAKODESH_HOME or the platform user-data directory for hakodesh. Never ~/spells.

Kernel commands

These are the runtime, not starter spells. Minted spell names are kebab-case. Kernel verbs are single tokens (devra, spellbook, run). Two-word leftovers stay kebab as aliases (grimoire-seal, run-intent, next-action).

Cast

Spellbook

Kinds — enchantments, wards, combos

These were never gone. They are first-class kernel commands:

Memory

Ledger

--like on an empty book uses the kind template in the wheel. After one spell exists, --like <that> copies its shape.

Every mint and cast emits hakodesh.event/v1. Akashic is SHA-256 linked and HMAC-SHA256 signed. Grimoire is Merkle-sealed with the same chain key. Promoted procedures use that same home key for procedure_mac. The keystore is $HAKODESH_HOME/keys (0700/0600), minted on first seal, never in the wheel.

Notifications default to none. The package does not write LaunchAgents or editor hooks until you mint and bind an enchantment.

SDK

from hakodesh.catalog import catalog
from hakodesh.mint import mint
from hakodesh import events, akashic, grimoire
from hakodesh.enchant import bind, lift
from hakodesh.ward import unlock
from hakodesh.combo import seal, cast
from hakodesh.memory import remember, recall, decide, run_intent, next_action, approve

See docs/PROCEDURAL_MEMORY.md and docs/MIGRATION.md.

Empty book law

A fresh install has zero user spells, enchantments, wards, combos, or promoted procedures. Discovery picks up a file the moment it lands under HAKODESH_HOME/book/.