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.