mdm

README

mdm

The markdown management CLI. No telemetry · Fully open source.

Install

macOS / Linux

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

Windows (PowerShell)

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

Both installers place the binary in ~/.local/bin/mdm and will warn if that directory isn't in your PATH.

To install to a different directory, set INSTALL_DIR before running:

INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/sethcarney/mdm/main/install.sh | bash

Usage

mdm rules link             Set up AGENTS.md as source of truth and symlink agent files
mdm rules status           Show the state of all agent instruction files
mdm rules unlink           Remove symlinks created by mdm rules link

mdm skills add <package>   Add a skill from GitHub or URL
mdm skills remove          Remove installed skills
mdm skills list            List installed skills
mdm skills find [query]    Search the registry
mdm skills update          Update installed skills
mdm skills audit           Check installed skills for updates and security advisories
mdm skills doctor          Check installed skills and project markdown for health issues
mdm skills init <name>     Scaffold a new skill
mdm skills install         Restore skills from skills-lock.json
mdm skills sync            Sync skills from node_modules
mdm upgrade                Upgrade the mdm CLI binary

Run mdm --help for the full command reference. See docs/rules.md for a detailed walkthrough of the mdm rules flow.

Skill installs run a deterministic local hidden-character scan over markdown files before copying or symlinking content. See docs/security/hidden-character-scan.md for the exact checks and bypass policy.

Development

make build    # compile to ./mdm
make test     # run all tests
make install  # install to $GOPATH/bin
go run . --help

See .vscode/launch.json for VS Code debug configurations.