Opens markdown files in a live-reloading cmux viewer panel with rich rendering for displaying plans, documentation, or notes alongside the terminal.
From claw-muxnpx claudepluginhub leejuoh/claude-code-zero --plugin claw-muxThis skill is limited to using the following tools:
references/commands.mdreferences/live-reload.mdDesigns and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.
Implements structured self-debugging workflow for AI agent failures: capture errors, diagnose patterns like loops or context overflow, apply contained recoveries, and generate introspection reports.
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
Use this skill to display markdown files in a dedicated panel with rich formatting and live file watching. Requires cmux environment ($CMUX_WORKSPACE_ID). Outside cmux, this skill's features are unavailable.
.md file.# Open a markdown file as a split panel next to the current terminal
cmux markdown open plan.md
# Absolute path
cmux markdown open /path/to/PLAN.md
# Target a specific workspace
cmux markdown open design.md --workspace workspace:2
The panel automatically re-renders when the file changes on disk. This works with:
echo "..." >> plan.md)If the file is deleted, the panel shows a "file unavailable" state. During atomic replace, the panel retries within a short window. If the file returns later, close and reopen the panel.
Write your plan to a file, then open it:
cat > plan.md << 'EOF'
# Task Plan
## Steps
1. Analyze the codebase
2. Implement the feature
3. Write tests
4. Verify the build
EOF
cmux markdown open plan.md
The panel live-reloads, so simply overwrite the file as work progresses:
# The markdown panel updates automatically when the file changes
echo "## Step 1: Complete" >> plan.md
# Open in the caller's workspace (default — uses CMUX_WORKSPACE_ID)
cmux markdown open plan.md
# Open in a specific workspace
cmux markdown open plan.md --workspace workspace:2
# Open splitting from a specific surface
cmux markdown open plan.md --surface surface:5
# Open in a specific window
cmux markdown open plan.md --window window:1
| Reference | When to Use |
|---|---|
| Commands | Full command syntax and options |
| Live Reload | File watching behavior, atomic writes, edge cases |
The markdown panel renders:
Supports both light and dark mode.