Mubu Integration

[English](README.md) | [中文](README.zh-CN.md)


mubu-integration

Turn Mubu (幕布) into a Markdown-native, AI-agent-controllable outliner.

[](https://github.com/liuboacean/mubu-integration/stargazers) [](https://github.com/liuboacean/mubu-integration/network/members) [](https://opensource.org/licenses/MIT) [](https://github.com/liuboacean/mubu-integration/actions/workflows/test.yml)

Manage your Mubu (幕布) outlines from the command line — **and as an AI Agent Skill** — with lossless Markdown import/export round-trip.

---

✨ Try it in 3 commands (magic moment)

python3 scripts/mubu_api.py create "周会" --md examples/weekly.md    # Markdown outline → Mubu
python3 scripts/mubu_api.py get  --export markdown > out.md  # Mubu → Markdown
diff weekly.md out.md                                              # no output = byte-for-byte identical


---

🆚 Why mubu-integration?

Capability	Manual copy	Existing export-plugin scripts	mubu-integration
Mubu → Markdown	✅	⚠️ partial	✅
Markdown → Mubu	❌	❌	✅ (only)
Round-trip fidelity (diff = no diff)	❌	❌	✅ (only)
Whole-tree batch / OPML / FreeMind	❌	⚠️ some	✅
Callable by an AI Agent	❌	❌	✅ (only)
Scriptable from the command line	❌	⚠️	✅

---

💡 Use cases

**① Let your AI Agent read & write Mubu directly** — turn Mubu into your Agent's long-term, structured memory.

python3 scripts/mubu_api.py get  --export markdown > memory.md   # Agent pulls the l