cmux

Automate cmux terminal multiplexer sessions on macOS.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mrmtsuruya/hermes-backup --skill cmux-mrmtsuruya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cmux
Source: https://github.com/mrmtsuruya/hermes-backup/tree/main/skills/cmux
Command: npx skills add https://github.com/mrmtsuruya/hermes-backup --skill cmux-mrmtsuruya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of managing and automating the control of cmux terminal multiplexer sessions, streamlining workflows for macOS users.

Core Features & Use Cases

  • cmux Workspace and Pane Management: Create, navigate, and manage cmux workspaces and panes.
  • Terminal Input and Notifications: Send input to terminals, manage notifications, and update sidebar metadata.
  • Browser Automation: Automate browser actions within cmux using WKWebView.
  • Markdown Viewer: Open and view markdown files within cmux.
  • Settings and Configuration: Customize cmux settings and manage configurations.
  • Agent Hooks and Install: Install and manage cmux skills for agents.
  • Use Case: A developer can use this Skill to automate the setup of a development environment with multiple terminal windows and browser panes, streamlining the process of working with different codebases and tools.

Quick Start

Use the cmux skill to open a new terminal pane in the current workspace and navigate to the local directory: cmux new-pane --type terminal --focus false && cmux send "cd ~\n" --surface surface:1

Frequently Asked Questions about cmux

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

FAQPage Schema
How do I automate terminal multiplexer sessions on macOS?▼

To automate terminal multiplexer sessions and send input on macOS, use this Skill to send keystrokes directly to cmux surfaces. It requires the cmux CLI and a Unix socket at /tmp/cmux.sock to manage workspace input and notifications.

Can I automate browser actions within a terminal workspace?▼

Yes, you can automate browser actions within a cmux terminal workspace using WKWebView integration. This Skill manages terminal panes while controlling browser views to streamline development environments and codebase workflows.

How do I open a new terminal pane and send commands to it?▼

To open a new terminal pane and send commands, use `cmux new-pane --type terminal --focus false` followed by `cmux send` with your input string. This Skill automates creating cmux surfaces and navigating local directories.

Do I need a specific Unix socket to manage cmux workspaces?▼

Yes, managing cmux workspaces requires a Unix socket located at /tmp/cmux.sock. The Skill relies on this socket connection to automate workspace navigation, pane management, and terminal input.

Can I view markdown files inside a cmux session?▼

Yes, you can open and view markdown files directly inside a cmux session. This Skill provides a markdown viewer feature alongside terminal automation, allowing you to read documentation without leaving your workspace.

What are the limitations of automating terminal workspaces with cmux?▼

The main limitation is platform dependency: cmux terminal automation is restricted to macOS environments. Additionally, the cmux CLI must be installed and the /tmp/cmux.sock Unix socket must be active for workspace management to function.