日本語 | English
A Claude Code skill package for AI-driven cmux terminal operations.
Claude Code's built-in Agent tool is convenient, but what happens inside is opaque. It's difficult to inspect sub-agent output or intervene mid-task, making debugging and quality control challenging.
With cmux, everything is visible. By launching sub-agents on cmux — a terminal multiplexer — you can monitor each agent's I/O in real time and intervene at any point.
The existing hashangit/cmux-skill dedicates roughly 50% of its content to browser automation, burying the most critical use case: sub-agent operations. This package restructures that content, putting sub-agent operation patterns front and center.
| Category | Description |
|---|---|
| Basic operations | Pane splitting, workspace management, command sending, screen reading |
Newline rules for send |
The most important rule — when to use \n vs. send-key return |
| Sub-agent launch pattern | Full lifecycle: launch → trust detection → prompt → completion detection → result collection |
read-screen troubleshooting |
Fixes for empty/stale output, refresh-surfaces, etc. |
| Notifications | cmux notify (in-app) vs. osascript (macOS Notification Center) |
| Status & progress | Sidebar status and progress bar control |
- using-cmux: General-purpose cmux CLI operations. Covers the full lifecycle of a single sub-agent
- cmux-team: Multi-agent orchestration. Handles team composition, task distribution, and synchronization. Built on top of using-cmux
- Claude Code installed
- cmux installed, with Claude Code running inside a cmux session
- macOS or Linux. Windows is not supported (the
bin/wrappers are POSIX shell scripts and rely onjq,cmuxCLI behavior tested only on macOS/Linux).
/plugin marketplace add hummer98/using-cmux
/plugin install using-cmux
Skills, commands, and hooks are installed together.
To update:
/plugin update using-cmux
/reload-plugins
Note: To pick up changes in the
bin/wrapper scripts (cmux-readetc.), you must restart the cmux session. The plugin'sbin/path is baked into PATH at session start.
npx skills add hummer98/using-cmuxNote: Commands (
/cmux) and wrapper scripts (cmux-readetc.) are not included in Agent Skills distribution. Use Option 1 for full functionality.
When Claude Code starts inside a cmux session, it detects the CMUX_SOCKET_PATH environment variable and automatically loads the skill. No manual setup required.
When Claude Code receives cmux-related instructions, it follows the patterns in SKILL.md to perform pane splitting, command sending, sub-agent launching, and more.
Display the quick reference:
/cmux
Useful for quickly checking available commands and basic usage.
The bin/ wrapper scripts (cmux-send, cmux-send-key, cmux-read) are thin wrappers around the cmux CLI. They:
- Take a
--surfacereference, look up the matching workspace viacmux tree --json, and forward the call tocmux send/cmux read/cmux send-key - Do not evaluate, interpolate, or modify the user-supplied payload — strings are passed verbatim to
cmux - Run with the user's own permissions; they do not elevate privileges or write outside
cmux - Have no network access of their own
Because these wrappers send keystrokes to a chosen cmux surface, an agent that can call cmux-send can in principle execute arbitrary commands inside the target surface (this is by design — that is what cmux is for). Treat installation of this plugin as granting the agent the same capability as a user typing into your terminal panes.