Repository navigation
ZCombine has been rebuilt from the ground up. The batch-script generator
is gone; v2 is a Python-native, cross-platform project aggregator
with a new CLI, a rewritten GUI, and a much faster combining engine.
🚨 Breaking Changes
v1's .bat workflow is gone.
| v1 | v2 |
|---|---|
zcm setup → generates zcm.bat |
zcm setup → generates zcm.config.json |
Run zcm.bat to combine |
Run zcm combine to combine |
| Windows only | Windows + Linux |
Existing users must reinstall. The installer cleans up v1 automatically.
✨ Highlights
- 🐍 Python-native core — no more batch, no more PowerShell, no more
fragile string parsing. Up to 100× faster on large projects. - 🐧 Linux support — full installer, desktop entry, uninstaller.
- ⌨️ New CLI —
zcm init,zcm setup,zcm combine. - 📝 JSON config —
zcm.config.json, committable and shareable. - 🎨 Rewritten GUI — fresh "Midnight Aurora" theme, click-to-toggle
chips, graceful error handling. - 📦 Portable builds —
zcm-portable.exe/zcm-portablefor
no-install usage. - 🌳 Project mind-map — optional tree at the top of the output for
better LLM context.
📥 Downloads
| Platform | Installer | Portable |
|---|---|---|
| Windows | zcm-setup.exe |
zcm-portable.exe |
| Linux | zcm-setup |
zcm-portable |
Linux users:
chmod +x zcm-setup && ./zcm-setup
🔄 Migration
- Uninstall v1.
- Install v2.
- In each project:
zcm init zcm combine
📖 Full Details
For the complete feature list, CLI reference, configuration schema, and
usage guide, see the README.
Full Changelog: v1.0.0...v2.0.0