Mindm Mindmap
Overview
Use the mindm-mindmap CLI to query the current MindManager map or create a new
map from Mermaid. This skill targets high-level map operations that mirror the
MCP server capabilities.
Quick start
Get the current mindmap as JSON:
uvx --from mindm mindm-mindmap get-mindmap --mode content
Get the current selection:
mindm-mindmap get-selection --mode content
Get grounding information:
mindm-mindmap get-grounding-information --mode content
Serialize to Mermaid:
mindm-mindmap serialize-mermaid
mindm-mindmap serialize-mermaid --mode full --id-only
Create a map from Mermaid:
mindm-mindmap create-from-mermaid --input /tmp/map.mmd
Create a map from Mermaid (full metadata or simplified indentation).
The CLI auto-detects the format.
Round-trip test (serialize → create):
mindm-mindmap serialize-mermaid --mode full | mindm-mindmap create-from-mermaid
Notes
- Keep MindManager open with the target map active before running the CLI.
- For macOS, use --macos-access applescript (default) or appscript.
- For full flag details, read references/cli.md.
- For full Mermaid metadata (notes, links, icons, tags), read references/mermaid.md.
- JSON responses return the raw data for the command. Errors return
{"error": "...", "message": "..."}.
Troubleshooting
| Problem |
Solution |
| "No active document" error |
Open a map in MindManager before running the CLI |
| Empty response or timeout |
Ensure MindManager is responsive (not showing a modal dialog) |
| Permission denied (macOS) |
Grant Accessibility permissions to Terminal/IDE in System Settings → Privacy & Security |
appscript import error |
Install with pip install appscript or use --macos-access applescript |
| Mermaid parse error |
Check syntax; use --mode full output as reference for valid format |
| Icons not appearing |
Verify stock icon index exists (see references/mermaid.md) |