cmux-markdown — Claude Code skill: viewer and install
Opens Markdown files in a formatted panel beside the terminal and reloads the view when files change. Useful for plans, notes, and docs.
npx skills add manaflow-ai/cmux --skill cmux-markdown -a claude-codeWhat cmux-markdown does
The skill writes or uses a Markdown file and opens it with cmux markdown open. Relative paths resolve from the caller’s current directory, ~ expands, and the command returns the resolved absolute path. Each overwrite or append triggers a fresh render.
The viewer handles headings, fenced code, tables, nested lists, blockquotes, links, and images. It supports light and dark modes. Write the complete file before opening it, so the panel does not show a half-written plan. You can also add a rule to AGENTS.md so project agents open plans through cmux.
What it helps with
- open a plan beside the terminal
- render project docs as formatted Markdown
- refresh notes when another process edits them
- show task lists in a side panel
Example prompts for the agent
- Write the plan to
plan.mdand open it beside the current terminal withcmux. - Open
design.mdin acmuxpanel and keep the view updated as the file changes. - Show
PLAN.mdin workspaceworkspace:2usingcmux.
How to install cmux-markdown
1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-markdown -a claude-code2Manually: put the files in place
~/.claude/skills/cmux-markdown/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cmux-markdown/
1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-markdown -a codex2Manually: put the files in place
.agents/skills/cmux-markdown/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-markdown -a cursor2Manually: put the files in place
.cursor/skills/cmux-markdown/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install manaflow-ai/cmux cmux-markdown2Manually: put the files in place
.github/skills/cmux-markdown/SKILL.md1Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-markdown -a gemini-cli2Platform CLI
gemini skills install https://github.com/manaflow-ai/cmux --path skills/cmux-markdownManually: put the files in place
.devin/skills/cmux-markdown/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-markdown -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cmux-markdown
How do I install cmux-markdown in Claude Code?
Run npx skills add manaflow-ai/cmux --skill cmux-markdown -a claude-code. The skill file will be at ~/.claude/skills/cmux-markdown/SKILL.md.
What does cmux-markdown do?
It opens a Markdown file in a panel beside the terminal and re-renders the view when the file changes on disk. It is intended for plans, docs, task lists, and notes.
How does it handle file updates?
Overwrites and appends trigger a new render. Atomic saves from editors, sed -i, and VS Code are handled.