Skip to content

mdm

The markdown management CLI. Install skills, keep every harness's instruction file in sync, and audit them all for prompt-injection risks - from one fast, Go-native tool. No telemetry. Fully open source.

Get started Command reference View on GitHub

Install in one line

curl -fsSL https://raw.githubusercontent.com/sethcarney/mdm/main/install.sh | bash

irm https://raw.githubusercontent.com/sethcarney/mdm/main/install.ps1 | iex

Then link your instruction files and add your first skill:

mdm rules link                          # AGENTS.md becomes the source of truth
mdm skills add anthropics/skills        # install a skill for every configured harness

See the installation guide for other methods and PATH tips.

Why mdm?

Keeping CLAUDE.md, copilot-instructions.md, .cursorrules, and friends consistent is tedious. Add in installing, versioning, updating, and auditing skills across a dozen tools and it becomes a real maintenance burden. mdm solves exactly that.

  • 43 harnesses supported

    Claude Code, Cursor, Cline, GitHub Copilot, Gemini CLI, Codex, and 37 more - out of the box. Run mdm harnesses list --available for the full list.

  • One source of truth

    mdm rules link makes AGENTS.md canonical and symlinks every harness's expected filename to it.

    Rules guide

  • Skills from anywhere

    Install from GitHub, GitLab, arbitrary URLs, local paths, or the skills.sh registry.

    skills add

  • Fork and make it yours

    mdm skills cherry-pick vendors a third-party skill into your own repo to edit and ship, with its source, ref, commit, and license recorded alongside it. Updates never overwrite a fork.

    skills cherry-pick

  • Security-focused by default

    Every install runs a deterministic scan for hidden characters and prompt-smuggling patterns. mdm skills audit checks OSV advisories.

    Security scans

  • Reproducible installs

    Commit an mdm.lock so teammates run mdm skills install once and onboard with whatever harness they prefer.

    skills install

  • Knowledge bundles

    mdm knowledge installs, validates, and updates Open Knowledge Format (OKF) bundles.

    Knowledge

  • Agent Plugins

    mdm plugins installs and validates Agent Plugins - portable packages of skills and MCP servers.

    Plugins

The command surface at a glance

mdm
├── skills        Manage skills for AI harnesses (add · cherry-pick · remove · list · find · update · audit · init · install · sync)
├── rules         Link/unlink harness instruction files to a single AGENTS.md
├── harnesses     Manage the configured harness list used as default install targets
├── agents        Manage agent definitions installed into harnesses (add · list · remove · update · install)
├── knowledge     Manage OKF knowledge bundles
├── plugins       Manage Agent Plugins (skills + MCP servers)
├── doctor        Check skills, agent definitions, bundles, plugins, and project markdown
├── migrate       Fold v1 lock files into mdm.lock and mdm-state.json
├── bug           Open a prefilled bug-report form (no network I/O)
├── experimental  Manage experimental feature gates
├── upgrade       Self-update the mdm binary from GitHub releases
├── uninstall     Remove the mdm binary from your system
└── completion    Generate shell completion scripts

Every command, flag, and alias is documented on the Command reference page.

Prefer a UI?

There's also an mdm VS Code extension that wraps the same functionality in a sidebar.