vusys / cm-tools

v0.3.0 2026-08-09 21:05 UTC

Requires

• php: ^8.4
• ext-mbstring: *
• league/commonmark: ^2.5
• symfony/console: ^7.0

Requires (Dev)

• infection/extension-installer: ^0.1.2
• infection/infection: ^0.34.2
• larastan/larastan: ^3.0
• laravel/pint: ^1.18
• orchestra/testbench: ^9.0 || ^10.0 || ^11.0
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^12.0 || ^13.0
• rector/rector: ^2.0

MIT

• Bryan

• markdown
• github
• jira
• lint
• commonmark
• reflow

Published on Packagist.org on 2026-08-09 21:06 UTC

README

CommonMark tools, shipped as a single binary.

• Fixed-width reflow — wrap a document's prose to a column width, or collapse it back to one line per paragraph.
• Dialect validation — check a document against a target Markdown dialect (strict CommonMark, GitHub, JIRA Cloud) and report constructs it doesn't support.

Install

Download the latest cm-tools binary from the releases page and put it on your PATH:

chmod +x cm-tools
mv cm-tools /usr/local/bin/

Or, as a Composer dependency:

composer global require vusys/cm-tools

Usage

# Wrap to 80 columns (the default)
cm-tools wrap README.md
cm-tools wrap README.md --width=100 --output=README.wrapped.md

# Collapse back to one line per paragraph
cm-tools unwrap README.wrapped.md

# Check against a dialect — exits non-zero if anything doesn't fit
cm-tools lint notes.md --dialect=jira-cloud
cm-tools lint notes.md --dialect=github     # the default

# Report which known dialects a document is compatible with
cm-tools detect notes.md

All four document commands read from stdin and write to stdout when no file/--output is given, so they compose:

cm-tools wrap --width=72 < draft.md | cm-tools lint --dialect=jira-cloud -

Run cm-tools <command> --help for the full option list.

Dialects

Key	What it models
commonmark	The base CommonMark spec — no GFM extensions, no footnotes. Renders identically anywhere CommonMark is supported.
github	GitHub Flavored Markdown as rendered on github.com — tables, strikethrough, task lists, autolinks, footnotes. Flags the small set of raw-HTML tags GitHub strips/escapes.
jira-cloud	The constrained Markdown-shortcut syntax JIRA Cloud's editor accepts in descriptions/comments — not classic JIRA wiki markup. Best-effort baseline; expect it to grow as real documents surface gaps.

Using cm-tools with Claude Code

An assistant only reaches for a tool it knows exists. install-skill writes a skill describing what cm-tools does and when to use it, so it doesn't have to be explained again every session:

cm-tools install-skill           # ./.claude/skills/cm-tools/SKILL.md, for this project
cm-tools install-skill --user    # ~/.claude/skills/cm-tools/SKILL.md, for every project
cm-tools install-skill --print   # write it to stdout and touch nothing on disk

Parent directories are created as needed, and the resolved path is printed so you can see which scope won. An existing SKILL.md is left alone unless you pass --force.

Development

See CONTRIBUTING.md for the local dev workflow, and CLAUDE.md for a map of how the package fits together.

License

MIT — see LICENSE.