Destiny BookOPEN SOURCE · CLI + AGENT SKILL
The Destiny Book client and Agent Skill for AI agents are open source under the MIT license, with the code on GitHub. The client calls the chart engine running on the mymingshu.com server, and one call returns the chart facts and the engine determinations: beyond the Four Pillars, hidden stems and Ten Gods you get the structure, the Day Master strength with its evidence, the Useful, Favorable and Unfavorable Elements, seasonal balance, wealth vault, benefactors, Shensha and the career palace. The engine decides; your AI explains.
npm install -g github:PanYX/mingshu-bazi01 / Install
The CLI installs straight from GitHub, so no npm account is needed. Run mingshu setup afterwards and it wires the chart engine into your AI assistant.
Send the message below to Codex, Claude Code or another assistant that can run local commands. It installs the client and checks the connection for you.
Install Destiny Book for me: https://github.com/PanYX/mingshu-bazi
Read docs/agent-install.md in the project, then complete the installation and connection check.You need Node.js 20 or later and Git. Two commands; the second one asks whether you use Codex or Claude Code.
npm install -g github:PanYX/mingshu-bazi
mingshu setupnpm is only the installer here. Keep the full github:PanYX/mingshu-bazi address rather than the package name mingshu-cli, which is not published to npm.
Not ready to install? Create a chart on the website and see what the same engine returns.
Create a chart onlineTrying it online needs no installation, and nothing is uploaded from or saved to your machine.
02 / The difference
Most open-source BaZi skills return the Four Pillars and the Ten Gods. Ask what your Useful Element is and the assistant has to invent an answer. Destiny Book has the engine make that call, then lets your AI explain it.
The gap is not whether the Four Pillars are computed correctly. It is who makes the calls on the Useful Element, the favorable and unfavorable elements and the strength evidence. The engine returns the determination with its basis, and the AI explains it. Neither one pretends to be the other.
03 / Real output
This is the unedited response for a fictional example, reproduced exactly as the engine returns it. The Useful, Favorable and Unfavorable Elements and the strength evidence are already inside, so the assistant does not have to guess.
Xin Metal (辛) · Follow-the-Strong Structure · Follow-the-Strong
Useful Element: Metal Favorable: Earth Unfavorable: Fire
Seasonal balance: Bing Fire (丙) · Ren Water (壬) · Wu Earth (戊) (Excellent)
Five Elements: Wood 4% Fire 10% Earth 43% Metal 38% Water 5%
Ten Gods: Companions 38% Resource 43% Output 5% Wealth 4% Authority 10%
Year Pillar 辛未 Friend
Month Pillar 辛丑 Friend
Day Pillar 辛巳 Day Master
Hour Pillar 己亥 Indirect Resource
Luck Cycles: 甲辰 2021-2030 · 乙巳 2031-2040 · 丙午 2041-2050 · 丁未 2051-2060Without flags, the terminal prints a readable brief.
{
"judgments": {
"pattern": "Follow-the-Strong Structure",
"strength": {
"label": "Follow-the-Strong",
"deLing": {
"ok": true,
"text": "Month Branch Chou Earth (丑) supports the Day Master."
}
},
"useful": [
"Metal"
],
"favorable": [
"Earth"
],
"unfavorable": [
"Fire"
]
},
"chartDigest": "e733dfec6fbb98c2f17b4dd946ad19aa1f6bd76476b7cda226f12431a1eb0226"
}With --json the determinations arrive with their evidence and field names, ready for an assistant to cite. Request the same chart in all five languages and the digest stays identical.
04 / Live check
This is a real call to the public API. Run it again in another language: the facts, the enum values and the digest stay the same, and only the wording follows the language.
05 / Commands
Every command supports --json. Failures exit with code 1 and return an error carrying a code and a message.
mingshu setupInstall the Skill into your AI assistant and check the service connectionmingshu version --jsonShow the CLI and Node.js versionsmingshu capabilities --jsonList capabilities, input contract and limitsmingshu doctor --jsonCheck service connectivity without sending birth detailsmingshu example --jsonPrint a fictional sample birth inputmingshu validate --input birth.json --jsonValidate input locally, with no network requestmingshu locations --query "Shanghai" --locale en --jsonLook up a city-level place IDmingshu chart --input birth.json --jsonCreate the chart and return the facts and determinationsmingshu skillsPrint the bundled Skill in fullmingshu website --locale enPrint website links without opening a browserThe default service address is https://mymingshu.com. Override it with --origin or MINGSHU_API_ORIGIN; a different address means birth details go to that server instead.
06 / Boundaries
The client, the API contract, the Skill and the documentation live in a public repository under the MIT license. You can use, modify and redistribute them.
The chart engine, accounts and paid reports run on the mymingshu.com servers and are not part of the open repository. The CLI calls the live API, so you do not have to run anything yourself.
A chart request sends only what you enter, to the address you choose. There is no database write and no profile. Links back to the website carry a source parameter and no birth details. The client never charges you and never calls a model.
Structure, Day Master strength, the Useful, Favorable and Unfavorable Elements and the seasonal balance all come from fixed tables. They are this engine's determinations and may differ from other schools. Element and Ten Gods percentages are engine weights, not probabilities. Readings stay inside a cultural tradition and are not medical, legal or investment advice.
FAQ
It is the open-source command line client for the chart engine behind Destiny Book, MIT licensed and free to use or redistribute. It only creates charts and returns the engine determinations. It does not generate AI readings and does not charge anything.
Most open-source projects return the Four Pillars and the Ten Gods, leaving the Useful Element to the assistant. Here fixed tables supply the structure, the Day Master strength evidence, the Useful and unfavorable elements and the seasonal balance. The assistant explains them and cannot rewrite them.
Node.js 20 or later and Git. The install command pulls straight from GitHub, so no npm account is required, and an AI assistant that can run local commands can do the whole step for you.
No. The request sends your details only to the address you choose, and the endpoint writes no database row and creates no profile. Links back to the website carry a source parameter and no birth date, time or place.
No. Structure, strength and the Useful Element come from fixed tables in this engine and may differ from other schools. Treat them as one traditional reading among several, and keep real-world information in the picture for decisions that matter.
07 / Docs
The public repository documents the installation, the API contract and worked demos.
Once it is installed, tell your assistant to use Destiny Book and read your BaZi chart. It collects the birth details, calls the CLI and explains what comes back.
npm install -g github:PanYX/mingshu-baziThe client is distributed straight from GitHub. No npm account, and no access to your local files.