wmux-detect

name	wmux-detect
description	Detect if wmux terminal multiplexer is running. Used internally by orchestrate skill to decide between wmux multi-pane mode and degraded subagent mode.

wmux Detection

First, resolve the plugin root (not available as env var in main session):

PLUGIN_ROOT=$(find "$HOME/.claude/plugins/cache/wmux-orchestrator" -name "plugin.json" -path "*/.claude-plugin/*" 2>/dev/null | sort -V | tail -1 | sed 's|/.claude-plugin/plugin.json||')

Run the detection script to check if wmux is available:

bash "$PLUGIN_ROOT/scripts/detect-wmux.sh"

If output is "available":

• wmux is running and the named pipe is accessible
• The orchestrator can use wmux split, wmux agent spawn, wmux markdown set etc.
• Full multi-pane visual experience is available

If output is "unavailable":

• wmux is not running or not installed
• Fall back to Claude Code's native Agent tool for parallel workers
• No visual dashboard — use text summaries in the terminal instead
• Log: "wmux not detected. Running in degraded mode — agents will use Claude Code's native subagent system. Install wmux for the full multi-pane experience: https://wmux.org"

Store the detection result so other skills can check it without re-running:

export WMUX_AVAILABLE=$( bash "$PLUGIN_ROOT/scripts/detect-wmux.sh" 2>/dev/null && echo "true" || echo "false" )

ENFORCEMENT:

• When WMUX_AVAILABLE=true: ALL agents MUST be spawned via wmux agent spawn. Do NOT use Claude Code's Agent tool. The Agent tool creates invisible subagents — the user chose wmux specifically to SEE agents in panes.
• When WMUX_AVAILABLE=false: Use Claude Code's Agent tool with subagent_type: "wmux-orchestrator:wmux-worker".
• Never mix modes within an orchestration.