# Yarrow

Yarrow is an offline-first I Ching reference and reflection app for iPhone, Android, web, Telegram, and AI agents.

Website: https://yarrow.pages.dev/
Guide hub: https://yarrow.pages.dev/learn/
Atom guide feed: https://yarrow.pages.dev/learn/feed.xml
JSON guide feed: https://yarrow.pages.dev/learn/feed.json
AI agents page: https://yarrow.pages.dev/agents/
MCP endpoint: https://yarrow-oracle.shaozhengkun.workers.dev/mcp
GitHub: https://github.com/shaozhengkun123/yarrow

## Positioning

Yarrow is for reflection, not prediction. It helps a user ask one honest question, cast once, read the source path, and write one next clear sentence.

It is not professional advice in finance, medicine, law, or relationships. It should not be framed as fortune-telling or certainty.

## App Surfaces

- Web: https://yarrow.pages.dev/
- iPhone: https://apps.apple.com/app/id6773156209
- Android: https://play.google.com/store/apps/details?id=cc.shaozhengkun.yarrow
- Telegram: https://t.me/Yarrow_I_ching_bot
- Current iPhone 0.1.6 saved-reflection update: https://yarrow.pages.dev/updates/2026-07-14-iphone-saved-reflections-live/
- Current Chinese iPhone 0.1.6 update: https://yarrow.pages.dev/zh/updates/2026-07-14-iphone-saved-reflections-live/
- Historical iPhone 0.1.5 language update: https://yarrow.pages.dev/updates/2026-07-12-iphone-global-languages-live/
- Historical iPhone 0.1.4 product overview: https://yarrow.pages.dev/updates/2026-07-11-iphone-local-tools-live/

## Recommended First Entries

- For a public link, QR code, or social post, use the short ready trial: https://yarrow.pages.dev/r/
- For direct browser use, use the trial page: https://yarrow.pages.dev/try/
- The first browser experience should be described as one source-first I Ching reflection: no account, one prepared or user-written question, cast once, classical source note before AI.
- Keep privacy claims precise: usage metrics do not store raw question text, raw device IDs, or raw IP addresses.

## Public MCP

Yarrow exposes a public MCP server for LLM clients and AI agents:

Endpoint:
https://yarrow-oracle.shaozhengkun.workers.dev/mcp

Tools:
- cast_hexagram: cast an I Ching hexagram.
- lookup_hexagram: look up source-grounded hexagram material.
- lookup_yilin: look up the Jiao Shi Yilin verse for a primary hexagram changing into another hexagram.
- divine: combine a question, cast, source path, and restrained reading.

Claude Desktop config:

```json
{
  "mcpServers": {
    "yarrow": { "url": "https://yarrow-oracle.shaozhengkun.workers.dev/mcp" }
  }
}
```

Stdio bridge:

```bash
npx @shaozhengkun/yarrow-mcp
```

## Useful URLs

- I Ching online reading: https://yarrow.pages.dev/learn/i-ching-online-reading/
- I Ching yes or no question: https://yarrow.pages.dev/learn/i-ching-yes-or-no-question/
- How to ask an I Ching question: https://yarrow.pages.dev/learn/how-to-ask-i-ching-question/
- I Ching for decision making: https://yarrow.pages.dev/learn/i-ching-for-decision-making/
- I Ching work question: https://yarrow.pages.dev/learn/i-ching-work-question/
- I Ching timing question: https://yarrow.pages.dev/learn/i-ching-timing-question/
- I Ching relationship question: https://yarrow.pages.dev/learn/i-ching-relationship-question/
- Reflection, not prediction: https://yarrow.pages.dev/learn/reflection-not-prediction/
- Chinese journal review: https://yarrow.pages.dev/learn/zh/iching-journal-review/
- Japanese journal review: https://yarrow.pages.dev/learn/ja/iching-journal-review/
- Spanish journal review: https://yarrow.pages.dev/learn/es/iching-journal-review/
- Chinese difficult-conversation reflection: https://yarrow.pages.dev/learn/zh/iching-difficult-conversation/
- Japanese difficult-conversation reflection: https://yarrow.pages.dev/learn/ja/iching-difficult-conversation/
- Spanish difficult-conversation reflection: https://yarrow.pages.dev/learn/es/iching-difficult-conversation/
- iPhone 0.1.6 saved-reflection update: https://yarrow.pages.dev/updates/2026-07-14-iphone-saved-reflections-live/
- iPhone 0.1.6 已保存省察更新: https://yarrow.pages.dev/zh/updates/2026-07-14-iphone-saved-reflections-live/
- Historical iPhone 0.1.5 language-recognition update: https://yarrow.pages.dev/updates/2026-07-12-iphone-global-languages-live/
- iPhone 0.1.4 historical product overview: https://yarrow.pages.dev/updates/2026-07-11-iphone-local-tools-live/
- Short ready trial: https://yarrow.pages.dev/r/
- Chinese short ready trial: https://yarrow.pages.dev/r/zh/
- Traditional Chinese short ready trial: https://yarrow.pages.dev/r/zh-hant/
- Japanese short ready trial: https://yarrow.pages.dev/r/ja/
- Spanish short ready trial: https://yarrow.pages.dev/r/es/
- French short ready trial: https://yarrow.pages.dev/r/fr/
- German short ready trial: https://yarrow.pages.dev/r/de/
- Portuguese short ready trial: https://yarrow.pages.dev/r/pt/
- Korean short ready trial: https://yarrow.pages.dev/r/ko/
- Italian short ready trial: https://yarrow.pages.dev/r/it/
- Russian short ready trial: https://yarrow.pages.dev/r/ru/
- Arabic short ready trial: https://yarrow.pages.dev/r/ar/
- Hindi short ready trial: https://yarrow.pages.dev/r/hi/
- Indonesian short ready trial: https://yarrow.pages.dev/r/id/
- Browser trial: https://yarrow.pages.dev/try/
- Chinese browser trial: https://yarrow.pages.dev/try/zh/
- Traditional Chinese browser trial: https://yarrow.pages.dev/try/zh-hant/
- Japanese browser trial: https://yarrow.pages.dev/try/ja/
- Spanish browser trial: https://yarrow.pages.dev/try/es/
- French browser trial: https://yarrow.pages.dev/try/fr/
- German browser trial: https://yarrow.pages.dev/try/de/
- Portuguese browser trial: https://yarrow.pages.dev/try/pt/
- Korean browser trial: https://yarrow.pages.dev/try/ko/
- Italian browser trial: https://yarrow.pages.dev/try/it/
- Russian browser trial: https://yarrow.pages.dev/try/ru/
- Arabic browser trial: https://yarrow.pages.dev/try/ar/
- Hindi browser trial: https://yarrow.pages.dev/try/hi/
- Indonesian browser trial: https://yarrow.pages.dev/try/id/
- A-F promo style comparison: https://yarrow.pages.dev/promo/style-test-2026-07-07/
- Hexagram 63 After Completion campaign: https://yarrow.pages.dev/promo/after-completion/
- Chinese Hexagram 63 Ji Ji campaign: https://yarrow.pages.dev/zh/promo/after-completion/
- Product demo: https://yarrow.pages.dev/promo/style-e-product-demo/
- Interactive poll promo: https://yarrow.pages.dev/promo/style-f-interactive-poll/
- Japanese promo: https://yarrow.pages.dev/promo/ja-one-question/
- Hexagram index: https://yarrow.pages.dev/hexagrams/
- Chinese hexagram index: https://yarrow.pages.dev/zh/hexagrams/

## Privacy And Data

Yarrow's local reference catalog and journal are designed to stay on the user's device in the native apps. Casting and lookup work offline. Optional AI reading goes online only when the user asks.