Xmind for AI agents — create and edit .xmind mind maps from Claude Code, Cursor, Codex, Gemini CLI and more.
Works on local files and live cloud documents at xmind.app.
# 1. Install the CLI
npm install -g @xmindltd/xmind-cli
# 2. Install skills into your agent's skill directory
npx skills add xmindltd/xmind-cliThe second command auto-detects your installed agents (Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Windsurf, GitHub Copilot, Antigravity) and symlinks the skill files into the right place.
To install only specific skills:
npx skills add xmindltd/xmind-cli -s xmind-file,xmind-cloud| Skill | When to use | CLI surface |
|---|---|---|
xmind-file |
Local .xmind files (default) |
xmind create / read / add / update / theme / batch / image |
xmind-cloud |
Real-time editing on xmind.app | xmind cloud auth / open / batch / upload |
xmind-illustrated-map |
Mind maps with generated topic images (requires image-gen agent) | xmind image-plan / enrich-images |
This repository is the install entry — the three SKILL.md files distributed via npx skills add and the marketplace declaration in .claude-plugin/marketplace.json. The CLI binary and the knowledge it loads on demand ship via npm install -g @xmindltd/xmind-cli.
Once installed, just talk to your agent:
"Make a mind map about the evolution of transportation, with images for each era."
The agent picks the right skill, plans the structure, generates content, and produces a .xmind file you can open in Xmind.
- Xmind — desktop and cloud apps that read
.xmindfiles - Agent Skills spec — the format these skills follow
MIT