Getting Started
This page shows how to install jsMind V2 and create a first map with the CLI.
Install
Pick one of the following. They are alternatives, not sequential steps.
npm install
Install the 2.x version with:
npm i jsmind@2WARNING
npm i jsmind still installs v1 (0.9.x). Use npm i jsmind@2 for the 2.x version.
2.x is a rewrite, published under the npm dist-tag v2-preview. It is not a drop-in replacement for v1 yet.
After installing the package, you can run the CLI with npx jsmind.
Build from the repository
To build and run the CLI from this repository you need Node.js >= 22.12.0:
git clone https://github.com/hizzgdev/jsmind-v2.git
cd jsmind-v2
npm install
npm run buildFrom the repository root, run the local CLI with npx jsmind or node dist/cli.js. The commands below use npx jsmind; node dist/cli.js is equivalent.
Create a first map
Create a map, read the root id from context, add a child, validate, and export a PNG:
$ npx jsmind create tmp/hello.json --title "Hello"
created tmp/hello.json
$ npx jsmind context tmp/hello.json
root Hello {side=center}
$ npx jsmind mind add-child tmp/hello.json --parent-id root --text "World"
added jm-mwh96wk6 under root
$ npx jsmind validate tmp/hello.json
tmp/hello.json: valid
$ npx jsmind export tmp/hello.json tmp/hello.png
tmp/hello.png: 2400x1600 (85.0 KB)The root id in this example is root. Child ids are generated; when you run these commands, use the ids from your current context output, and do not copy example ids.
export needs a Chromium browser. If it is not in a standard location, set CHROME_PATH. See the CLI page for options and the rest of the commands.
Try the Playground
You can also open the Playground to view, edit, and export a map in the browser — no install required.
If you want an agent to draw or edit a map with the CLI, see the Skill page.