cmux-workspace-builder

Generate a valid cmux.json workspace configuration through a guided interview.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/ajelinek/skills-stash --skill cmux-workspace-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cmux-workspace-builder
Source: https://github.com/ajelinek/skills-stash/tree/main/cmux-workspace-builder
Command: npx skills add https://github.com/ajelinek/skills-stash --skill cmux-workspace-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

cmux workspace builder helps developers design and generate a cmux.json workspace configuration through a guided interview, ensuring a correct, repeatable multi-pane terminal setup.

Core Features & Use Cases

  • Guided interview to collect pane counts, pane purposes, commands, directories, and environment variables to produce a valid cmux.json.
  • Generates nested layouts using binary splits and validates against the latest cmux schema so you can reuse configurations across projects.
  • Use case: prepare a multi-pane environment with frontend, API, and logs panes and save the result as cmux.json for quick re-creation.

Quick Start

Describe your desired multi-pane workspace and I will guide you through configuring a cmux.json file.

Frequently Asked Questions about cmux-workspace-builder

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

FAQPage Schema
How do I generate a cmux.json configuration for a multi-pane terminal workspace?

To generate a cmux.json configuration, you describe your desired multi-pane terminal layout and complete a guided interview. The interview collects pane counts, commands, directories, and environment variables, then outputs a validated JSON file for repeatable workspace setup.

Can I customize environment variables and directories for each pane in my terminal layout?

Yes, you can customize environment variables and directories for each pane in your terminal layout. The guided interview collects specific per-surface options, ensuring each pane in your cmux.json configuration operates with its own distinct commands and environment settings.

What is a binary tree split and how does it structure a terminal workspace layout?

A binary tree split is the layout rule used to structure your terminal workspace by recursively dividing panes into two surfaces. The cmux workspace builder enforces these binary splits and validates per-surface options against the latest schema before generating the JSON.

Does the cmux workspace builder validate my configuration against the latest schema?

Yes, the cmux workspace builder validates your configuration against the latest cmux schema. It loads the schema before generating the final JSON, ensuring your multi-pane terminal layout, binary tree splits, and per-surface options conform to the required rules.

What's the best way to set up a repeatable multi-pane terminal environment for frontend, API, and logs?

The best way to set up a repeatable multi-pane terminal environment is using a guided interview to generate a cmux.json file. You define pane purposes like frontend, API, and logs, and the tool outputs a validated configuration to quickly recreate the workspace.