@q-ching/tui

An I-Ching oracle in your terminal — cast from live quantum entropy and the rhythm of your own typing.

q-ching casts a reading by mixing true/quantum randomness (the NIST randomness beacon, reachable directly from Node) with the entropy of your own keystroke timing, then draws the six lines, looks up the primary hexagram, computes the changing lines, and derives the transformed hexagram.

Install

npm install -g @q-ching/tui

Use

q-ching

Requires a real interactive terminal (it uses raw-mode key input) and Node ≥ 20. Follow the ritual: cross the threshold, hold your question, let it gather entropy, and read what is cast.

How it works

This is a thin client over @q-ching/core, the dependency-free engine that does the entropy mixing and casting math. See the project README for the full story.

License

MIT