Skip to content
Get packs

OpenRig cmux Terminal Views

Open OpenRig fleet views of live agent terminals into the cmux terminal app (best-effort provider)

Source Download skill
Repository
mvschwarz/openrig
Stars
8,553
Licence
Apache-2.0
Files
1 file

What it does

This skill teaches an AI agent how to take a group of OpenRig-managed AI agents (a rig, pod, mission, slice, or saved view) and display their terminals as tiles in the cmux terminal app, using the command rig terminal --provider cmux. It explains the same view rules used by the sibling herdr skill, such as read-only views for missions and slices, and how failures are reported. cmux is described as a best-effort option, with herdr as the default.

Great for

  • Developers who already run OpenRig and use cmux as their terminal app
  • Operators who want to watch several agent terminals side by side in cmux
  • Users who specifically asked for cmux rather than the default herdr provider

Skip it if

  • Users who do not run OpenRig, since the skill only works with its rig, pod, and view commands
  • Situations needing a guaranteed result, because cmux is explicitly best-effort and a miss is not treated as a failure
  • Use on production agent seats where live tmux option changes could disrupt work; the skill itself warns to test in an isolated environment first

Try asking

  • “Open my backend rig into cmux as live agent tiles”
  • “Show the mission mission:release-42 in cmux, read-only”
  • “Reopen my saved view 'on-call' in cmux”
  • “Check whether cmux is healthy for OpenRig terminal views”
Step-by-step guide: how to use OpenRig cmux Terminal ViewsInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    openrig-cmux.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip openrig-cmux.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip openrig-cmux.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask for herdr by default; only request cmux when you specifically need it
  • Use the saved-view name or a rig/pod/mission/slice identifier so the agent resolves the right view
  • If a remote host's agents are missing from the tiles, check the reported reason, since http-registered hosts need ssh

What's inside

  • SKILL.md

Redistributed unmodified from mvschwarz/openrig under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.