Yarrow — An I-Ching oracle for the agent era
[App Store]
[MCP]
[License: MIT]
Yarrow lets you (and your agents) consult the Book of Changes — cast a hexagram, read the classical sources, and get a Wilhelm/Baynes-style reflection. Offline-first iOS app, plus a public MCP server so any LLM agent can reach the same oracle.
"The I-Ching does not predict; it mirrors. The question you bring decides the reading."
What's in this repo
The iOS source lives separately at yarrow-ios (TODO).
For users
📱 iOS app
Download on the App Store → · $4.99 · iOS 17+ · no tracking, no account.
All 64 hexagrams and their classical commentary ship in the app; AI reading is optional and runs through this Worker.
🤖 Agents
Claude Code — install the plugin:
Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json:
Codex CLI / Hermes / older Claude Desktop — use the stdio bridge:
Or pin it in your client's config — see INTEGRATIONS.md for every platform.
Anyone with curl —
The MCP tools
Self-hosting
This Worker is MIT — fork, deploy your own, point your agents at your URL.
Your endpoint will be https://yarrow-oracle.<your-subdomain>.workers.dev.
Boundaries
Yarrow is for reflection, not prediction. The system prompt baked into the Worker refuses:
- fortune-telling / specific future predictions
- medical, legal, or financial advice
- requests to "reveal what will happen"
The classical voice is direct; the framing is Jungian. This is the line we draw, in the iOS app and the MCP both.
License
MIT for code; classical sources are in the public domain. See LICENSE.