Cmux Markdown

This opens markdown files in a formatted side panel with live reload, which is exactly what you want when Claude writes a plan.md and you need to watch it update in real time. The panel auto-refreshes on file changes, renders tables and code blocks properly, and supports the usual markdown syntax. It's built for the agent workflow where you're dumping task lists or documentation to a file and want them visible alongside your terminal without alt-tabbing. The routing options let you target specific workspaces or surfaces if you're running a complex cmux layout. Straightforward tool that does one thing well.

skills.sh installs: 7.8K
GitHub stars: 28.7K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add manaflow-ai/cmux --skill cmux-markdown --agent claude-code

Installs into .claude/skills of the current project.

Files

Markdown Viewer with cmux

Write a .md file, open it in a panel, and the panel re-renders whenever the file changes on disk. Use it for agent plans and task lists alongside the terminal, documentation and changelogs while working, and notes another process updates progressively.

cmux markdown open plan.md                              # split next to the current terminal
cmux markdown open /path/to/PLAN.md
cmux markdown open design.md --workspace workspace:2    # also --surface, --window

Relative paths resolve against the caller's cwd and ~ expands; the resolved absolute path comes back in the output.

Agent usage

Write the full plan file first, then open it, so the panel never shows a partially written file. After that, overwrite or append freely: each write triggers a re-render, and atomic replacement (editor saves, sed -i, VS Code) is handled.

To instruct coding agents in a project, add to its AGENTS.md:

## Plan Display

When creating a plan or task list, write it to a `.md` file and open it in cmux:

    cmux markdown open plan.md

The panel renders markdown with rich formatting and auto-updates when the file changes.