trails/.agents/skills/cmux-markdown/references/commands.md
Ullrich Schäfer 19f2275b73 Move skills to .agents/skills for cross-agent compatibility
Skills now live in .agents/skills/ — the standard convention
aligned with Pi, OpenAI Codex, and the Agent Skills spec.

.claude/skills is a symlink back to .agents/skills/ so Claude
Code still discovers them.

Updated CLAUDE.md to document the setup.
2026-06-09 13:31:20 +02: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: