cmux

Create and manage terminal tabs and splits in cmux workspaces.

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/sergical/pi-config --skill cmux-sergical
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cmux
Source: https://github.com/sergical/pi-config/tree/main/skills/cmux
Command: npx skills add https://github.com/sergical/pi-config --skill cmux-sergical

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines terminal management by allowing you to create, control, and monitor multiple terminal sessions (tabs and splits) within a single workspace, preventing context switching and improving workflow efficiency.

Core Features & Use Cases

  • Session Management: Create new terminal tabs (surfaces) or split panes for running development servers, test runners, or background tasks.
  • Command Execution: Send commands to specific terminal sessions and read their output.
  • Workflow Orchestration: Manage multi-terminal workflows, such as running a dev server in one tab and monitoring its output in another.
  • Use Case: Start a Node.js dev server in a new tab, then run automated tests in another tab, and monitor both processes simultaneously.

Quick Start

Create a new terminal tab and run 'npm run dev' inside it.

Frequently Asked Questions about cmux

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

FAQPage Schema
How do I manage multiple terminal sessions in a single workspace?

You can manage multiple terminal sessions by creating new tabs or split panes within a single workspace. This prevents context switching and streamlines multi-terminal development workflows by allowing you to monitor background tasks and dev servers simultaneously.

Can I execute commands in specific terminal tabs and read their output?

Yes, you can send commands to specific terminal sessions and read their output. This allows you to execute a command in one surface and monitor its results, facilitating the orchestration of complex multi-terminal workflows.

Do I need any specific environment setup to orchestrate terminal sessions?

You need the cmux tool installed and configured with a CMUX_SOCKET_PATH environment variable. This setup is required to create surfaces, split panes, and execute commands across your terminal workspace.

What is the best way to run a dev server and test runner simultaneously?

The best way is to create separate terminal tabs or splits for each process. You can start your Node.js dev server in one surface and run automated tests in another, monitoring both processes simultaneously within one workspace.

Why should I use terminal session orchestration for development workflows?

Terminal session orchestration streamlines development by allowing you to control and monitor multiple terminal sessions within a single workspace. This improves workflow efficiency by preventing context switching between different windows.