cmux Documentation Skill
Overview
cmux is a native macOS terminal application built on Ghostty (libghostty),
designed for developers running multiple AI coding agents simultaneously.
Key features include vertical tabs, notification rings, split panes, an
embedded browser, and a Unix socket API for automation. It is
GPU-accelerated, built with Swift and AppKit (no Electron), and is free
and open-source.
Documentation URL Reference
When answering questions about cmux, fetch the relevant documentation page
from cmux.com using WebFetch. Select the most relevant URL based on the
user's question:
Source Selection
Classify the user's question, then pick the information source:
| Question type |
Examples |
Source |
| CLI usage, subcommands, flags, syntax |
"how do I list panes?", "cmux browser commands", "what flags does new-workspace take?" |
Bash first: run cmux -h or cmux <subcommand> --help |
| API / scripting / automation |
"how to automate cmux", "send keys to a pane via script" |
Bash first, then WebFetch the API page if deeper context needed |
| Concepts, config, GUI, shortcuts, teams |
"keyboard shortcuts", "how workspaces work", "notification settings", "claude code teams" |
WebFetch from the URL table above |
| Ambiguous or broad |
"tell me about cmux panes", "how do splits work?" |
Both: Bash for CLI details + WebFetch for conceptual context |
How to Answer
Classify the user's question using the Source Selection table above.
For Bash-first questions:
- Run
cmux -h to get the full command list, or
cmux <subcommand> --help for details on a specific subcommand.
- The CLI help output is authoritative for syntax, flags, and available
subcommands -- it reflects the user's installed version.
- If the help output fully answers the question, use it directly.
- If the user needs more context (examples, workflows, rationale),
supplement by fetching the relevant cmux.com page with WebFetch.
For WebFetch questions:
- Select the most relevant URL from the Documentation URL Reference table.
- Use WebFetch with a targeted extraction prompt.
- If the first page does not answer, try a different page from the table.
For both-sources questions:
- Start with Bash to get the concrete CLI details.
- Then fetch the relevant cmux.com page for conceptual context.
- Merge both into a unified answer.
For simple questions like "what is cmux?", answer from the Overview above
without fetching, unless the user asks for more details.
Response Format
- Provide concise, actionable answers
- Include relevant code snippets, configuration examples, or keyboard
shortcuts when applicable
- Link to the source documentation page so the user can read more
- If the documentation does not cover the user's question, state this clearly
rather than speculating
Source: take0x/cmux-skills — distributed by TomeVault.
1---2name: cmux3description: Use this skill when the user asks about cmux, mentions cmux terminal, asks about cmux configuration, keyboard shortcuts, custom commands, notifications, browser automation, the cmux API, cmux split panes, cmux vertical tabs, cmux workspaces, or Claude Code agent teams in cmux. Also use when the user asks about a native macOS terminal for AI coding agents built on Ghostty, or references cmux.com documentation.4---56# cmux Documentation Skill78## Overview910cmux is a native macOS terminal application built on Ghostty (libghostty),11designed for developers running multiple AI coding agents simultaneously.12Key features include vertical tabs, notification rings, split panes, an13embedded browser, and a Unix socket API for automation. It is14GPU-accelerated, built with Swift and AppKit (no Electron), and is free15and open-source.1617- **GitHub**: https://github.com/manaflow-ai/cmux18- **Website**: https://cmux.com1920## Documentation URL Reference2122When answering questions about cmux, fetch the relevant documentation page23from cmux.com using WebFetch. Select the most relevant URL based on the24user's question:2526| Topic | URL |27|---|---|28| Installation and setup | https://cmux.com/docs/getting-started |29| Core concepts (windows, workspaces, panes, surfaces) | https://cmux.com/docs/concepts |30| Configuration (Ghostty config) | https://cmux.com/docs/configuration |31| Keyboard shortcuts | https://cmux.com/docs/keyboard-shortcuts |32| Custom commands and workspace layouts | https://cmux.com/docs/custom-commands |33| CLI and Unix socket API | https://cmux.com/docs/api |34| Notifications and alerts | https://cmux.com/docs/notifications |35| Browser automation | https://cmux.com/docs/browser-automation |36| Claude Code agent teams | https://cmux.com/docs/claude-code-teams |37| Changelog and version history | https://cmux.com/docs/changelog |38| Blog posts and news | https://cmux.com/blog |39| General overview | https://cmux.com |4041## Source Selection4243Classify the user's question, then pick the information source:4445| Question type | Examples | Source |46|---|---|---|47| CLI usage, subcommands, flags, syntax | "how do I list panes?", "cmux browser commands", "what flags does new-workspace take?" | **Bash first**: run `cmux -h` or `cmux <subcommand> --help` |48| API / scripting / automation | "how to automate cmux", "send keys to a pane via script" | **Bash first**, then WebFetch the API page if deeper context needed |49| Concepts, config, GUI, shortcuts, teams | "keyboard shortcuts", "how workspaces work", "notification settings", "claude code teams" | **WebFetch** from the URL table above |50| Ambiguous or broad | "tell me about cmux panes", "how do splits work?" | **Both**: Bash for CLI details + WebFetch for conceptual context |5152## How to Answer53541. Classify the user's question using the Source Selection table above.55562. For **Bash-first** questions:57 - Run `cmux -h` to get the full command list, or58 `cmux <subcommand> --help` for details on a specific subcommand.59 - The CLI help output is authoritative for syntax, flags, and available60 subcommands -- it reflects the user's installed version.61 - If the help output fully answers the question, use it directly.62 - If the user needs more context (examples, workflows, rationale),63 supplement by fetching the relevant cmux.com page with WebFetch.64653. For **WebFetch** questions:66 - Select the most relevant URL from the Documentation URL Reference table.67 - Use WebFetch with a targeted extraction prompt.68 - If the first page does not answer, try a different page from the table.69704. For **both-sources** questions:71 - Start with Bash to get the concrete CLI details.72 - Then fetch the relevant cmux.com page for conceptual context.73 - Merge both into a unified answer.74755. For simple questions like "what is cmux?", answer from the Overview above76 without fetching, unless the user asks for more details.7778## Response Format7980- Provide concise, actionable answers81- Include relevant code snippets, configuration examples, or keyboard82 shortcuts when applicable83- Link to the source documentation page so the user can read more84- If the documentation does not cover the user's question, state this clearly85 rather than speculating8687---88> Source: [take0x/cmux-skills](https://github.com/take0x/cmux-skills) — distributed by [TomeVault](https://tomevault.io).89<!-- tomevault:4.0:skill_md:2026-06-16 -->
tomevault-io