cmux

Orchestrate terminal sessions across cmux panes to automate workflows.

5|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/jiahao-shao1/cmux-skill --skill cmux-jiahao-shao1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cmux
Source: https://github.com/jiahao-shao1/cmux-skill/tree/main
Command: npx skills add https://github.com/jiahao-shao1/cmux-skill --skill cmux-jiahao-shao1

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Coordinate multiple terminal sessions across cmux panes to orchestrate work across surfaces, split regions, and coordinated commands.

Core Features & Use Cases

  • Terminal orchestration: split panes, create workspaces, send commands, and poll outputs across surfaces.
  • Sub-agent spawning: launch Claude Code instances in parallel panes.
  • Browser automation: automate cmux's built-in browser to open URLs, interact with pages, and take screenshots.
  • Markdown preview: display plan.md or other markdown alongside the terminal.
  • Sidebar status: reflect progress and logs for active tasks.

Quick Start

Split panes, spawn sub-agents, and open a plan.md in a preview panel.

Frequently Asked Questions about cmux

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I orchestrate multiple terminal sessions in parallel?▼

You can orchestrate terminal sessions by splitting panes across workspaces, sending commands to individual panes, and polling their outputs to coordinate parallel task execution and sub-agent spawning.

Can I launch sub-agents in parallel panes to run Claude Code instances?▼

Yes, you can spawn sub-agents by launching Claude Code instances in parallel panes to execute multiple workflows simultaneously and monitor their terminal outputs from a coordinated workspace.

How do I preview markdown files alongside the terminal?▼

You can preview markdown files by displaying documents like plan.md in a dedicated preview panel alongside the terminal, allowing you to reference plans while executing commands.

Does cmux support automating a browser to take screenshots?▼

Yes, cmux supports browser automation by using the built-in browser to open URLs, interact with page elements, and capture screenshots directly within the orchestrated workspace environment.

What is needed to detect the CMUX_WORKSPACE_ID context for orchestration?▼

Detecting the CMUX_WORKSPACE_ID context requires an environment with frontmatter-defined name and description specified, enabling the orchestration system to identify and manage the active workspace.