User guide

This app offers two consultation styles: I Ching and Bones. It is a symbolic reflection tool and should not replace medical, financial, or other professional advice.

Consultation Modes (Main Selector)

• I Ching: Hexagram and changing-line reading for deep reflection and open questions.
• Bones: Yes/no reading based on crack patterns to validate decisions and immediate direction.

Options (bottom panel)

In Options you pick the consultation type (I Ching or Bones); with I Ching you also pick the cast mode (automatic or manual), see allowed depth for the active thread, manage tokens and 2FA, and find links to documentation, privacy, and terms at the bottom.

The Pillars of Wisdom (Translators)

• Wilhelm/Baynes: Psychological and poetic interpretation (Free/Seeker level).
• James Legge: Structural and historical approach (Seeker level).
• Zhou Yi (Original): The pure canonical text in classical Chinese (Practitioner level).
• Master (3): Customized masterful synthesis of all three lineages for a definitive verdict (Master level).

Changing-line reading

By default, the app implements Alfred Huang's single-line reduction system, with Zhu Xi's classical structure as its antecedent. From Options you can enable the Changing-line reading selector to use Zhu Xi's classical reading instead; either way, every combination of changing lines always yields a single, precise guiding text.

How to use the methods

I Ching and Bones are different methods. I Ching reads by hexagram and lines and offers two casting modes: Three Coins and Yarrow Stalks. Bones follow a separate scheme, without hexagrams.

• Three Coins: The quick way to cast the I Ching. It works either automatically (the app casts for you) or manually (you record the six lines from your own physical coins). The result and the interpretation are the same in both modes.
• Yarrow Stalks: The slower, ritual I Ching method and the oldest one. The app offers it in manual mode: after casting with your own stalks or any equivalent support, you record line by line to build the hexagram. It is meant for those who want to keep the contemplative rhythm of the classical practice.
• Oracle Bones: Short question, short answer. Always automatic: the system generates the crack pattern and verdict, and the AI articulates it in your language. Useful for direct confirmations or when you want clarity rather than a long reflection.

I Ching: automatic or manual cast

With I Ching selected in Options you can pick the cast mode. In both cases the server applies the same classical line-selection rules and the same text base; only who supplies the six lines before interpretation changes.

• Automatic: when you send the consultation, the ritual animates the pattern and the six lines are generated on the server.
• Manual: an assistant opens for you to record the six lines bottom to top. With Three Coins, enter heads/tails per line; with Yarrow Stalks, record your physical cast step by step. After all six lines you will see a hexagram preview; you are responsible for accurately reflecting your physical throw.

Sessions and Messages (Chat Management)

• New Session: Start a clean chat with its own thematic continuity.
• Chat History: Access your previous consultations, interpretations, and images. Allows reviewing or deleting specific threads.

Tokens, limits, and packs

Each consultation consumes one token. Balance is cumulative: every pack adds to whatever you already have. What changes with your pack is the balance size and how many chained readings fit in the same thread. The Master (3) synthesis consumes 2 tokens per consultation.

Library and Documentation

We offer a library that includes the complete collection of the 64 hexagrams using the three main sources of the work: the classical translation by Wilhelm/Baynes, the version by James Legge, and the original Zhou Yi (Chinese) text. This section allows you to compare your answers or manual casts with the authentic writings, designed for the serious study of the I Ching. The texts are presented in their original format to preserve the absolute fidelity of the sources.

• Each hexagram page has three tabs: Wilhelm/Baynes, James Legge, and the original Zhou Yi text in Classical Chinese.
• Wilhelm's and Legge's tabs add an optional classical commentary, shown as a small "+" next to the Judgment, the Image, and each line. It expands the scholar's own notes (Wilhelm's commentary plus the Confucian Ten Wings; Legge's footnotes plus his Great and Lesser Symbolism) without changing the oracle text itself.
• Hexagrams 1 and 2 include one extra closing note, Wen Yen ("Words on the Text"), present only for these two hexagrams in Wilhelm's source edition.
• Use the search box to find a hexagram by number, English name, or pinyin, or filter the list by its upper or lower trigram.
• Each hexagram page lists its six possible mutations: which hexagram results when one specific line changes, so you can browse the network of related hexagrams.
• This classical commentary is for study inside the Library only. It is never sent to the AI during a live consultation.

• Hexagram Library: Direct consultation of all 64 hexagrams and works.
• Documentation: User guide · Method notes and origins (I Ching and Bones) · Privacy Policy · Terms of Service · FAQs · About the app.

Export and save

From the Options panel you may, whenever you choose, download the reading image and generate a PDF of the active chat. This is optional: it is for keeping a copy on your own computer or device. The PDF is built in your browser; it does not replace in-app history and you are not required to keep copies outside the service. The PDF includes the translator and the line-reading system used in that consultation.

Privacy

• Your chats and images are tied to your account and are only accessible while you are signed in.
• The service does not expose your history or consultation topics outside your own authenticated access.
• If you want a record on your device, you may, at your sole discretion, download a reading image and export the current thread to PDF from Options; those files are generated locally on your device and you are responsible for keeping them.