Read your Obsidian vault's fortune. A Five-Elements diagnostic for your notes — cyber fortune-telling for your second brain.
A read-only Claude Code plugin. Point it at your Obsidian vault, and it tells you the shape of your knowledge system in terms of the Chinese Five Elements (水 Water, 木 Wood, 火 Fire, 土 Earth, 金 Metal) — input, understanding, creation, reality, method.
No files are moved, renamed, or modified. The only new file is a report.
/plugin install github:tianchichen/five-elements-scan
/wuxing-scan ~/path/to/your/vault
(Or run with no arguments inside your vault's folder.)
The plugin will:
- Scan every
.mdfile in your vault - Group notes (by top-level folder, or by tag for flat vaults)
- Read a sample from each group
- Classify each group into one of the Five Elements
- Write
five-elements-report.mdinto your vault root
See examples/sample-report.md for a full example. The report includes:
- 整体分布 Overall distribution — percentage and count per element
- 按分组 By group — each of your folders, classified
- 观察 Observations — prose describing the tensions in your vault
- 建议 Suggestions — 3–5 concrete, vault-specific moves
- 相生循环健康度 Generation cycle health — which phase transitions flow and which stagnate
The Five Elements are not substances but phases of flow. Water becomes Wood becomes Fire becomes Earth becomes Metal — and Metal, once distilled, shapes what new Water you pay attention to.
Water 水 → Wood 木 → Fire 火 → Earth 土 → Metal 金 → Water 水
(input) (understand) (create) (live) (method) (new input)
Most folder systems ask "what is this about?" This one asks "what is this doing?" Is it flowing in, growing, taking form, landing in reality, or becoming method?
That question, applied across your whole vault, gives you a picture you can't get from tags alone.
给你的 Obsidian Vault 算一命。 一个只读的五行诊断插件，把你的笔记当作能量的相位来看。
这是一个 Claude Code plugin。用一条 /wuxing-scan 命令扫描你的 Obsidian vault，按照中国古代五行（水、木、火、土、金）——对应输入、理解、创造、现实、方法五个阶段——给出分布、失衡诊断和 3–5 条针对你的 vault 的具体建议。
全程只读，不会移动、重命名或修改任何笔记。唯一的产出是一份 five-elements-report.md。
详细中文文档见 README.zh.md。
Inspired by Dumo's Five-Elements folder structure for Obsidian (see the original Reddit post).
MIT — see LICENSE.