SKILL.md
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](references/cli.md).
- For full Mermaid metadata (notes, links, icons, tags), read [references/mermaid.md](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](references/mermaid.md)) |