cmux-agent-observer-skill

cmux-agent-observer is a portable skill package for running visible multi-pane agent workers with cmux, tmux, Codex, and OpenCode.

The animated overview above shows the core loop: launch visible worker panes, keep long-running sessions attachable with tmux, inspect progress from cmux, and leave short handoff notes in .cmux-handoffs/.

It does not make native subagents automatically appear as panes. Instead, it gives you a stable orchestration layer that:

• creates worker panes in cmux
• optionally wraps each worker in its own tmux session
• launches codex, opencode, or custom shell workers in each pane
• keeps handoff notes and observation helpers close to the skill

assets/
  demo.svg
cmux-agent-observer/
  SKILL.md
  agents/openai.yaml
  references/official-notes.md
  scripts/
install.sh
package.sh

Global install for both Codex and OpenCode-compatible skill locations:

bash install.sh --target both

Install only for Codex:

bash install.sh --target codex

Install only for .agents/skills:

bash install.sh --target agents

Install into a specific project:

bash install.sh --target project --project-dir /path/to/project

Create two visible worker panes from the current cmux pane:

./.agents/skills/cmux-agent-observer/scripts/launch.sh \
  --tool codex \
  --workspace current \
  --worker planner::"Split the task into concrete slices." \
  --worker review::"Review only the auth changes."

Create a dedicated workspace:

./.agents/skills/cmux-agent-observer/scripts/launch.sh \
  --tool opencode \
  --workspace new \
  --title auth-board \
  --worker planner::"Plan the rollout." \
  --worker verify::"Validate behavior and report gaps."

Open a browser split beside a worker:

./.agents/skills/cmux-agent-observer/scripts/browser.sh open http://127.0.0.1:3000

• The stable model is cmux panes + separate worker processes.
• Native subagent features do not automatically map to cmux panes.
• For long-running workers, keep tmux enabled.
• For portable packaging, run:

bash package.sh

This builds a distributable tarball in dist/.

MIT