cmux

Automate cmux terminal layouts, browser interactions, and notifications via its socket API.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/merong/cmux-workshop --skill cmux-merong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cmux
Source: https://github.com/merong/cmux-workshop/tree/main/plugins/cmux-workshop/skills/cmux
Command: npx skills add https://github.com/merong/cmux-workshop --skill cmux-merong

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

cmux enables developers to control a macOS terminal app and an embedded browser from Claude Code, automating layouts, browser interactions, and notifications without manual commands.

Core Features & Use Cases

  • Orchestrate windows, workspaces, panes, and surfaces to build complex terminal+browser layouts.
  • Automate browser interactions alongside terminal tasks, including opening URLs and sending notifications when tasks complete.
  • Real-world scenario: quickly set up a development workspace that pairs a code pane with a browser pane and gets a notification when builds finish.

Quick Start

Ask Claude Code to open a new cmux workspace with a split pane and an embedded browser.

Frequently Asked Questions about cmux

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

FAQPage Schema
How do I automate terminal layouts and browser interactions from Claude Code?

You can automate terminal layouts and browser interactions from Claude Code by using the cmux skill, which sends commands through the cmux socket API to manage windows, panes, and an embedded browser on macOS.

Can I send macOS notifications when terminal builds finish using Claude Code?

Yes, you can send macOS notifications when builds finish by asking Claude Code to use cmux, which orchestrates terminal tasks and triggers system notifications upon completion.

What do I need to run cmux commands through Claude Code on macOS?

To run cmux commands through Claude Code, you need a locally installed cmux app with a working socket and CLI, the skill loaded by Claude Code, and a macOS environment.

How do I set up a development workspace with a code pane and browser pane in macOS terminal?

You set up a development workspace with a code and browser pane by asking Claude Code to open a new cmux workspace, which orchestrates split panes and an embedded browser automatically.

Does Claude Code work with cmux to manage terminal workspaces and panes?

Claude Code works with cmux to manage terminal workspaces and panes by using the CLI interface and SKILL frontmatter to load instructions that control the cmux terminal app.

What are the limitations of using cmux for terminal automation with Claude Code?

The cmux terminal automation is limited to macOS environments and requires a functioning local cmux installation with an active socket API to execute commands from Claude Code.