https://github.com/sethcarney/mdm

agentic markdown management CLI
https://github.com/sethcarney/mdm

ai-tools cli markdown

Last synced: about 1 month ago
JSON representation

agentic markdown management CLI

• Host: GitHub
• URL: https://github.com/sethcarney/mdm
• Owner: sethcarney
• License: apache-2.0
• Created: 2026-04-20T14:44:05.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2026-05-26T23:03:18.000Z (about 2 months ago)
• Last Synced: 2026-06-03T18:04:04.661Z (about 1 month ago)
• Topics: ai-tools, cli, markdown
• Language: Go
• Homepage:
• Size: 11.4 MB
• Stars: 3
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# mdm

[![CI](https://github.com/sethcarney/mdm/actions/workflows/ci.yml/badge.svg)](https://github.com/sethcarney/mdm/actions/workflows/ci.yml)

[![CodeQL](https://github.com/sethcarney/mdm/actions/workflows/codeql.yml/badge.svg)](https://github.com/sethcarney/mdm/actions/workflows/codeql.yml)

[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/sethcarney/mdm/badge)](https://securityscorecards.dev/viewer/?uri=github.com/sethcarney/mdm)

[![SLSA 3](https://slsa.dev/images/gh-badge-level3.svg)](https://slsa.dev)

[![Go Report Card](https://goreportcard.com/badge/github.com/sethcarney/mdm)](https://goreportcard.com/report/github.com/sethcarney/mdm)

[![GitHub Release](https://img.shields.io/github/v/release/sethcarney/mdm)](https://github.com/sethcarney/mdm/releases/latest)

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/sethcarney/mdm)

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

## Install

**macOS / Linux**

```bash

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

```

**Windows** (PowerShell)

```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:

```bash

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    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      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](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](docs/security/hidden-character-scan.md) for the exact checks and bypass policy.

## Development

```bash

make build    # compile to ./mdm

make test     # run all tests

make install  # install to $GOPATH/bin

go run . --help

```

See [.vscode/launch.json](.vscode/launch.json) for VS Code debug configurations.