trails/.claude/skills/cmux-markdown/references/commands.md
Ullrich Schäfer b4c0ee954d
Add cmux skills (browser, debug-windows, markdown, core)
Skills for cmux terminal integration: browser automation for visual
verification, debug windows, markdown viewer, and core topology control.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-22 12:25:54 +01:00

1.7 KiB

Command Reference (cmux Markdown)

Opening a Markdown Panel

cmux markdown open <path>
cmux markdown <path>          # shorthand (implicit "open")

Options

Flag Description Default
--workspace <id|ref|index> Target workspace $CMUX_WORKSPACE_ID
--surface <id|ref|index> Source surface to split from Focused surface
--window <id|ref> Target window Current window

Output

OK surface=surface:8 pane=pane:3 path=/absolute/path/to/file.md

With --json:

{
  "window_id": "...",
  "workspace_id": "...",
  "pane_id": "...",
  "surface_id": "...",
  "path": "/absolute/path/to/file.md"
}

Path Resolution

  • Relative paths are resolved against the caller's current working directory.
  • ~ is expanded to the home directory.
  • The resolved absolute path is returned in the output.
# These are equivalent when run from /Users/me/project
cmux markdown open plan.md
cmux markdown open ./plan.md
cmux markdown open /Users/me/project/plan.md

Panel Behavior

  • The panel opens as a horizontal split to the right of the source surface.
  • The tab title shows the filename (e.g., plan.md).
  • The tab icon is a document icon.
  • Content is read-only with text selection enabled.
  • The file path is displayed as a breadcrumb at the top of the panel.

Session Persistence

Markdown panels are saved and restored across sessions. On restore, the panel re-reads the file from disk. If the file no longer exists at restore time, the panel is not recreated.

Help

cmux markdown --help
cmux markdown -h

See also: