Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add manaflow-ai/cmux --skill cmux-markdown -a claude-code
Open on GitHub

What 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.md and open it beside the current terminal with cmux.
  • Open design.md in a cmux panel and keep the view updated as the file changes.
  • Show PLAN.md in workspace workspace:2 using cmux.

How to install cmux-markdown

1Skills CLI (Vercel)

npx skills add manaflow-ai/cmux --skill cmux-markdown -a claude-code

2Manually: put the files in place

~/.claude/skills/cmux-markdown/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cmux-markdown/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set24

The whole set →
cmux Skill for navigating multi-pane cmux layouts: create windows, workspaces, splits, focus surfaces, and move terminals and browser panels without breaking automation. Use it when an agent needs deterministic placement and routing. CX Codex +1 9,700installs cmux-browser Automates browser surfaces via the cmux CLI without stealing user focus. Useful for background page inspections, waiting on selectors, and form fills. CX Codex +1 8,800installs cmux-settings A skill that reads and edits cmux settings in ~/.config/cmux/cmux.json: terminal, browser, Markdown, diff, notes and shortcuts. CX Codex +1 7,300installs cmux-workspace Keeps an agent's actions inside the cmux workspace and terminal that started it, so automation does not disturb whatever the user is looking at. CX Codex +1 6,900installs cmux-customization Configures the cmux workspace manager: edits cmux.json, wires Command Palette actions, sets dock terminals, and routes terminal-level styling directly to Ghostty. CX Codex +1 6,700installs cmux-diagnostics Skill runs read-only cmux diagnostics: sockets, hooks, session restore, settings. Use when notifications fail, agents don't resume, or you need a support-safe debug report. CX Codex +1 6,400installs cmux-keyboard-shortcuts Configures cmux shortcuts in ~/.config/cmux/cmux.json. Useful for adopting tmux-style chords, auditing overrides, and validating syntax. CX Codex +1 6,200installs cmux-dev-workflow This skill guides native cmux work, from repository setup to tagged app builds and sidebar extension checks. Use it when changing native build inputs. CX Codex +1 4,900installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor