Xmind Cloud CLI

Setup

which xmind || npm install -g @xmindltd/xmind-cli

Auth

xmind cloud auth status

{"authenticated":false}

xmind cloud auth login
# → Opens browser automatically, waits for authorization
# → {"authenticated":true,"source":"config"}

xmind cloud auth token <value>

Session Rules

• Reuse sessions: before opening, check

  xmind cloud sessions

  . If the document already has an active session, reuse it.
• Don't close after every edit: sessions persist and auto-close after 30 minutes of inactivity. Only close when the user is done or explicitly asks.
• Daemon persists across sessions: closing a session doesn't kill the daemon. Next

  open

  is faster.

Create

Step 1: Discover

xmind skill list

Step 2: Load Skills + Execute

xmind skill show recipes/<name> features features/strategy/<name>

1. Phase 1 — Content: Follow recipe rules to plan content.
2. Phase 2 — Render: Follow features + strategy rules to produce markdown, select skeleton and color. Substitute the execute command with cloud upload:
   bash

   cat <<'MD' | xmind cloud create --stdin --skeleton <name> --color <name>
   # Central Topic
   ## Branch
   ### Sub-branch
   MD

   Returns

   {"success":true,"fileId":"...","url":"https://app.xmind.com/<id>"}

   .

xmind skill show features/strategy/<other>

Edit

Connect (only if no active session)

xmind cloud sessions
# If empty or no session for this document:
xmind cloud open <link-or-fileId>
# → {"session":"abc","fileId":"...","root":"..."}

Quick Edit

xmind cloud read --session <id>
xmind cloud add --session <id> --parent <title> --topic <text>
xmind cloud update --session <id> --topic <old-title> --title <new-title>
xmind cloud delete --session <id> --topic <title>
cat <<'BATCH_EOF' | xmind cloud batch --session <id>
[{"op": "...", ...}]
BATCH_EOF

Guided Edit

xmind skill show editing/guide

xmind cloud batch --session <id>

Upload Existing File

xmind cloud upload output.xmind

Error Handling

• {"error":"token_expired"}

  → Token expired. Re-authenticate with

  xmind cloud auth login

  .

• {"error":"Session not found"}

  → Re-open:

  xmind cloud open <link>

  .

• {"error":"Authentication failed"}

  → Token invalid.

• {"error":"exceed_files_limit"}

  → Cloud storage full.