AgentStack
Sign in Publish
MCP servers Skills Toolkits Why AgentStack Sell Docs
Sign in
SKILL verified MIT Self-run

cmux Workspace Orchestration

skill-jack-michaud-faire-cmux · by jack-michaud

>-

↗ Repository
— No reviews yet
0 installs
16 views
0.0% view→install

Install

$ agentstack add skill-jack-michaud-faire-cmux

✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

Are you the author of cmux Workspace Orchestration? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

cmux Workspace Orchestration

cmux is a terminal multiplexer application for macOS with a rich CLI for managing windows, workspaces, panes, browser surfaces, and sidebar logging. It is controlled via a Unix socket at /tmp/cmux.sock.

Core Concepts

cmux organizes its hierarchy as: Window > Workspace > Pane > Surface (Tab)

  • Window: Top-level OS window
  • Workspace: A named layout within a window (like tmux sessions). Visible in the sidebar.
  • Pane: A split region within a workspace. Each pane contains one or more surfaces as tabs.
  • Surface: A single terminal or browser tab within a pane. Referenced as surface:.

All commands use ref format by default: workspace:1, pane:2, surface:3.

Environment variables CMUX_WORKSPACE_ID and CMUX_SURFACE_ID are auto-set in cmux terminals and serve as defaults for --workspace and --surface flags.

CLI Reference

Run cmux --help for the full command list. Run cmux --help for details on any specific command. Use --json flag on most commands for machine-readable output.

Tips

  • Use cmux identify --json to discover the current workspace, pane, and surface context.
  • After creating splits, use cmux list-panes and cmux list-pane-surfaces to discover new surface refs.
  • Use cmux capture-pane --lines to read terminal output and detect when processes are ready.
  • Use cmux log with levels (progress, success, error) and cmux notify for sidebar visibility.
  • Browser snapshot --interactive returns an accessibility tree ideal for understanding page structure.
  • cmux send uses \n for Enter and \t for Tab in the text argument.

Workflows

Successful workflows are documented as reference files. Check resources/ for proven patterns.

Resources

Custom docs written on cmux topics:

  • resources/workspace-survey.md — How to survey the current workspace state at the start of a session

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet — be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Agent Skills