#oh-my-claudecode

cmux omc launches Oh My Claude Code (OMC) in a cmux-aware environment. OMC is a multi-agent orchestration system for Claude Code with 19 specialized agents, smart model routing, and tmux-based team pipelines. When OMC spawns team panes, they become native cmux splits.

#Usage

cmux omc
cmux omc team 3:claude "implement feature"
cmux omc --watch

All arguments after omc are forwarded to the omc CLI.

#What you get

OMC's team mode uses tmux for pane management. With cmux omc, those panes become native cmux splits:

  • Team worker panes (Claude/Codex/Gemini sessions) appear as cmux splits in the workspace
  • HUD monitoring display shows live status in a split pane
  • Auto-layout management arranges agent panes in a main-vertical grid
  • Your main session stays in the primary pane while agents work beside it

#Prerequisites

npm install -g oh-my-claude-sisyphus

OMC requires Claude Code CLI installed and authenticated.

#How it works

Same pattern as cmux claude-teams. A tmux shim intercepts tmux commands from OMC and translates them into cmux API calls.

  • Creates a tmux shim at ~/.cmuxterm/omc-bin/tmux that redirects to cmux __tmux-compat
  • Sets TMUX and TMUX_PANE to simulate a tmux session
  • Prepends the shim directory to PATH
  • Injects NODE_OPTIONS restore module for Claude Code compatibility
  • Execs into omc with all remaining arguments forwarded

#Directories

PathPurpose
~/.cmuxterm/omc-bin/Contains the tmux shim script
~/.cmuxterm/tmux-compat-store.jsonPersistent storage for tmux-compat buffers and hooks

#Environment variables

VariablePurpose
TMUXFake tmux socket path encoding the current cmux workspace and pane
TMUX_PANEFake tmux pane identifier mapped to the current cmux pane
CMUX_SOCKET_PATHPath to the cmux control socket for the shim to connect to