Codex skills for MindManager automation using the mindm library.
This repository provides skills that enable LLM-powered tools (Claude Code, Codex, etc.) to interact with MindManager programmatically. Skills wrap the mindm CLI tools for mindmap operations and export functionality.
| Skill | Description |
|---|---|
| mindm-mindmap | High-level mindmap operations: read maps, get selections, serialize to Mermaid, create maps from Mermaid |
| mindm-export | Export mindmaps to multiple formats: Mermaid, Markmap, Markdown, JSON, YAML (HTML or data-only) |
- Retrieve current mindmap structure as JSON
- Get selected topics from active document
- Serialize maps to Mermaid (simplified or with full metadata)
- Create new maps from Mermaid syntax (auto-detects format)
- Round-trip conversion: MindManager → Mermaid → MindManager
- Export to HTML viewers: Mermaid, Markmap, Markdown
- Export to data formats: JSON, YAML, Mermaid, Markdown
- Stream output to stdout or write to file
- Open exported files automatically
| Feature | Windows | macOS |
|---|---|---|
| Topics & subtopics | Yes | Yes |
| Notes | Yes | Yes |
| Relationships | Yes | Yes |
| Icons | Yes | No |
| Images | Yes | No |
| Tags | Yes | No |
| Links | Yes | No |
| RTF formatting | Yes | No |
- Python 3.12+
- MindManager (tested with 23)
- mindm library
Install the mindm package:
pip install mindmOr run without installing via uvx:
uvx --from mindm mindm-mindmap get-mindmap --mode content
uvx --from mindm mindm-export --type mermaid_html --openmindm-skill/
├── .gitignore
├── AGENTS.md # Build instructions for agents
├── LICENSE
├── Makefile
├── README.md
├── mindm/skills/ # Packaged skill bundles (generated)
│ ├── mindm-export.skill
│ └── mindm-mindmap.skill
└── skills/ # Source skill definitions
├── mindm-export/
│ ├── SKILL.md
│ └── references/
│ └── cli.md
└── mindm-mindmap/
├── SKILL.md
└── references/
├── cli.md
└── mermaid.md
- mindm - Python library for MindManager automation
- mindm-mcp - MCP server for MindManager (deprecated, use these skills instead)
MIT