mdedit-cli

mdedit-cli

Official command-line interface for MD Editor.

Links:

• CLI docs
• MD Editor homepage

Install

npm install -g mdedit-cli

Get an API key

All APIs require authentication. Create an API key here:

• API key docs

Configure

mdedit config login --api-key <YOUR_KEY>

Config is stored at ~/.mdedit-cli/config.json.

Environment variables (optional)

• MDEDIT_API_URL (default: https://apiv2.mdedit.ai)
• MDEDIT_API_KEY
• MDEDIT_WORKSPACE_ID
• MDEDIT_CONFIG_DIR (override config directory)

Usage

mdedit --help
mdedit info
mdedit health

Agent / AI tool integration

The CLI is designed to be used by AI agents without modification.

Agent tips

• Use --format json for machine-readable output (human messages go to stderr)
• Pass all required flags on the command line to avoid interactive prompts
• Use --yes on destructive commands to skip confirmation
• Pipe content via --file - (stdin) or --content-only (stdout)

Skill file

A comprehensive agent skill document is included with the CLI. It covers all commands, flags, workflows, and error handling in a format optimised for AI agents (Claude Code, Cursor, GitHub Copilot, etc.).

# View the skill
mdedit skill show

# Install the skill into all detected agent config files
mdedit skill install

# Install into a specific tool only
mdedit skill install --target claude    # → CLAUDE.md
mdedit skill install --target cursor    # → .cursor/rules/mdedit.mdc
mdedit skill install --target codex     # → .github/copilot-instructions.md

# Install to home-directory (global) targets
mdedit skill install --global

OpenClaw plugin

An openclaw.json plugin manifest is included in the package. It defines every CLI tool as a structured, machine-readable entry that OpenClaw-compatible agents can load directly.

# Find the plugin manifest
node -e "console.log(require.resolve('mdedit-cli/openclaw.json'))"