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.

Getting started

This guide is practical: only how to use I Ching, Bones, and the options in the bottom panel.

1) Choose consultation mode

Each question can contain up to a maximum of 1500 characters, allowing you to provide all the necessary context for a deep and personalized response.

3) Results and local copy

Using the app and available options

These are the features you have at hand: the Options panel, Chats, new session, thread depth, token management, optional 2FA, and PDF/image export.

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.

Chats and sessions

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.

Hexagram Library and Works (Premium Option)

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.

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.

I Ching

Useful for open questions, dilemmas, and processes that unfold over time. It returns a hexagram, the changing lines that apply, and the resulting hexagram if any. Readings follow the classical Zhu Xi rules and the authentic source texts.

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.

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 Zhu Xi rules and the same text base; only who supplies the six lines before interpretation changes.

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.

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.

Packs and pricing

Current pricing:

Your tokens accumulate: if you buy a new pack before running out, your remaining tokens carry over and add to the new pack.

Library Access: Purchasing any paid pack permanently unlocks access to the Library, which contains the complete collection of 64 hexagrams across three literary works: the classic Wilhelm/Baynes translation, the James Legge version, and the original Zhou Yi.

Per-plan details (per-thread limits, consumable packs, and image resolution):

Privacy and related documents

This is a practical summary. For the binding details please read the privacy policy and the terms of service. If you want the historical background of the methods, see the method notes.

For full details, see the Privacy Policy and Terms of Service.

User Guide | The Original I Ching App