cmux

cmux is a skill for Claude Code, Codex from bks-lab/open-bridge. It costs 65 tokens per session (2,263 once invoked), scanned A, original, MIT.

A guide for using cmux, a terminal tool for arranging tabs, split panes, workspaces, and agent sessions. It also explains how to inspect and restore workspace layouts when work is lost.

In plain words
What is it for?
Use it to open tabs and splits, run or monitor parallel agents, inspect sessions, and restore saved cmux layouts.
Why use it?
It gives you a clear way to manage many terminal sessions and recover their arrangement after cmux crashes or restarts.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions Claude Code; mentions AGENTS.md.

Good fit Use it to open tabs and splits, run or monitor parallel agents, inspect sessions, and restore saved cmux layouts.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/bks-lab/open-bridge/cmux
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add bks-lab/open-bridge --skill cmux
Clone the repo
git clone --depth 1 https://github.com/bks-lab/open-bridge

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for cmux

README.md
[![agentmods](https://agentmods.dev/badge/skills/bks-lab/open-bridge/cmux/github.svg)](https://agentmods.dev/skills/bks-lab/open-bridge/cmux)
Your own site
<a href="https://agentmods.dev/skills/bks-lab/open-bridge/cmux"><img src="https://agentmods.dev/badge/skills/bks-lab/open-bridge/cmux/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for cmux

Your own site · 80×15
<a href="https://agentmods.dev/skills/bks-lab/open-bridge/cmux"><img src="https://agentmods.dev/badge/skills/bks-lab/open-bridge/cmux.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 65 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,263 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00065 $0.02263
Opus 5.5 $0.00026 $0.00905
Sonnet 5.5 $0.00013 $0.00453
Haiku 4.5 $0.00006 $0.00226

Measured 6d ago against content hash ac076e8e56b5, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

cmux scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

The scan reads SKILL.md. This mod also ships 7 executable files (scripts/cmux_driver.py, scripts/cmux_layout.py, scripts/cmux-claude-restart.sh, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/cmux/SKILL.md · 167 lines

How it starts

The opening of the file, as written. The whole thing — 167 lines — stays where its author put it; the contents beside it link to each section on GitHub.

cmux

Manage cmux workspaces, tabs and the agent sessions inside them from one terminal, and bring them back when cmux loses them.

Optional. Everything here needs the cmux CLI, found as $CMUX_BIN, else cmux on PATH, else the CLI inside the macOS app bundle (not on PATH under a service manager). Without it the skill does nothing: the scripts exit with a clear message and the workplace driver answers an error, which scripts/workplace.py reads as "tab view unknown", never as "no tabs open". Nothing else in the Bridge depends on cmux.

Decision tree

User wants to...
├── open a tab / split / workspace, spawn or watch an agent, sidebar, wait-for
│       → vocabulary table below, then references/local.md
├── "workspaces lost", "which sessions were running", cmux crashed or relaunched
│       → references/sessions.md: cmux_layout.py list → show → restore
├── one tab per task, "status of all tabs", "send <tab>: ..."
│       → scripts/workplace.py (CORE plan, docs/workplace.md) with this skill as driver
├── which session runs where, or what an agent is doing right now
│       → references/sessions.md: cmux sessions --json, vault search, agent journal
├── restart the agent in every tab (after an update)
│       → references/sessions.md § Restart
└── watch or answer agents on another machine, from a laptop or phone
        → references/remote.md

The workplace driver

scripts/workplace.py plans the day as workspaces with one agent tab per task and knows no terminal. This skill ships the cmux side of it. Wire it in bridge-config.yaml:

workplace:
  driver: {command: ["python3", "${root}/skills/cmux/scripts/cmux_driver.py"]}

Then python3 scripts/workplace.py open --yes [--here "$CMUX_SURFACE_ID"] opens the plan in cmux, and status, send, adopt steer the tabs. python3 scripts/workplace.py launch --items A,B --yes [--here "$CMUX_SURFACE_ID"] [--target tab|workspace|area|auto] opens one tab per chosen task or inbox item (docs/workplace.md § Launching chosen items). What the driver guarantees:

Read the full file on GitHub · 167 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago Changed · +12 lines ac076e8e56b5
  2. 11d ago First seen · 155 lines · 65 tokens per session scan A f22114255d08

Subscribe to this mod's changes

cmux is a skill published in the GitHub repository bks-lab/open-bridge (13 stars, last pushed today), licensed MIT. It adds 65 tokens to every session and 2,263 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-05.