macOS
Homebrew
The cleanest public install path on macOS.
brew tap dudash/tap
brew install mdmindDownloads
Install mdmind or grab the latest release.
GitHub Releases are the source of truth for public installs. Every release bundles both
mdm and mdmind, plus the example map pack.
Linux
Release tarball
Download the latest archive from the GitHub release page and put the binaries on your path.
Open latest releaseWindows
Release zip
Grab the latest Windows zip from GitHub releases and extract both binaries together.
Open latest releaseDevelopment
Install from source
For local development or testing directly from the repo:
cargo install --path .Agent mode
Install mdmind as a skill for your agents.
Teach Codex or Claude to write native mdmind maps and inspect them with
mdm. After cloning or downloading the repo, replace
/path/to/mdmind below with that folder, copy one or both skill folders into
your agent's skills directory, and restart the client.
What you get
Two focused skills
mdmind-map-authoring teaches agents to write clean native maps.
mdm-cli-inspection teaches them to validate, inspect, and export existing maps.
Codex
Install for Codex
Copy the skill folders into ~/.codex/skills.
mkdir -p ~/.codex/skills
cp -R /path/to/mdmind/skills/mdmind-map-authoring ~/.codex/skills/
cp -R /path/to/mdmind/skills/mdm-cli-inspection ~/.codex/skills/Claude
Install for Claude
For all projects, copy the same folders into ~/.claude/skills.
mkdir -p ~/.claude/skills
cp -R /path/to/mdmind/skills/mdmind-map-authoring ~/.claude/skills/
cp -R /path/to/mdmind/skills/mdm-cli-inspection ~/.claude/skills/Need the guide?
Full skill install notes
The repo includes a portable skills README, example prompts, and a small test harness for isolated Codex installs.
Open the skills READMETwo install paths
Install mdmind for yourself, then install the skills for your agents.
The binaries are for writing and exploring maps directly. The skill pack helps Codex, Claude, and similar tools produce native mdmind files with better structure.