Agent skill

cmux Window and Pane Control

by basicmachines-co in basicmachines-co/basic-memory

“End-user control of cmux topology and routing (windows, workspaces, panes/surfaces, focus, moves, reorder, identify, trigger flash). Use when automation needs deterministic…”

— description from SKILL.md by basicmachines-co
AGPL-3.0Auto-check passedProductivity & Automation

Install cmux Window and Pane Control

skills CLI
$ npx skills add basicmachines-co/basic-memory --skill cmux -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install basicmachines-co/basic-memory cmux --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/basicmachines-co/basic-memory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/cmux .claude/skills/cmux && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cmux
GitHub stars
4.1k
Used in
2 other repos
Token cost
~842 tokens
SKILL.md length
234 words
Files
6 (incl. references)
Skills in repo
49
Repo updated
First seen
Licence
AGPL-3.0

At a glance

  • SKILL.md covers Fast start, Handle model, Settings and Deep-dive references
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

About this skill

“End-user control of cmux topology and routing (windows, workspaces, panes/surfaces, focus, moves, reorder, identify, trigger flash). Use when automation needs deterministic placement and navigation in a multi-pane cmux layout.”

— description from SKILL.md by basicmachines-co

cmux Window and Pane Control is a skill in basicmachines-co/basic-memory (4.1k stars). Its SKILL.md is about 842 tokens, with 5 other files in the folder (references), and copies of it appear in 2 other owners' repositories. Licence: AGPL-3.0.

What it can do on your machine

Read from SKILL.md and the folder at commit 6982cfc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

cmux Window and Pane Control loads about 842 tokens when it runs, and up to ~1.7k if it reads all its reference files. Until then it costs about 58 tokens; SKILL.md has 234 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~842
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from basicmachines-co/basic-memory at commit 6982cfc, republished under its AGPL-3.0 licence (© basicmachines-co). 234 words, ~842 tokens.

Download SKILL.mdSave it as .claude/skills/cmux/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
cmux
description
End-user control of cmux topology and routing (windows, workspaces, panes/surfaces, focus, moves, reorder, identify, trigger flash). Use when automation needs deterministic placement and navigation in a multi-pane cmux layout.

cmux Core Control

Non-browser cmux topology and routing.

  • Window: top-level macOS cmux window.
  • Workspace: tab-like group within a window.
  • Pane: split container in a workspace.
  • Surface: a tab within a pane (terminal or browser panel).

Fast start

bash
cmux identify --json                              # current caller context
cmux list-windows / list-workspaces / list-panes
cmux list-pane-surfaces --pane pane:1
cmux new-workspace
cmux new-split right --panel pane:1
cmux move-surface --surface surface:7 --pane pane:2 --focus true
cmux split-off --surface surface:7 right
cmux reorder-surface --surface surface:7 --before surface:3

# workspace context-menu actions (color, description, rename, pin, ...)
cmux workspace-action --action set-color --color Blue
cmux workspace-action --action set-description --description "Ship checklist"

# attention cue
cmux trigger-flash --surface surface:7

Handle model

Output defaults to short refs (window:N, workspace:N, pane:N, surface:N). UUIDs are accepted as input; request UUID output only when needed with --id-format uuids|both.

Settings

cmux-owned settings live in ~/.config/cmux/cmux.json. cmux docs settings prints the docs URL, schema URL, raw GitHub resources, cmux.json paths, and reload command. cmux settings, cmux settings cmux-json, and cmux settings shortcuts open the UI.

cmux reload-config reloads both cmux.json and ~/.config/ghostty/config, refreshing terminals in place with no app restart.

Terminal rendering (font, cursor style, theme, scrollback, background-opacity, background-blur) belongs in Ghostty config, not cmux settings. Everything else (app behavior, sidebar, notifications, browser behavior, automation, workspace colors, cmux-owned shortcuts) is cmux settings. Before editing, copy any existing cmux.json to a timestamped .bak next to it. Legacy ~/.config/cmux/settings.json and ~/Library/Application Support/com.cmuxterm.app/settings.json are read only as fallback for missing keys.

Deep-dive references

ReferenceWhen to Use
references/handles-and-identify.mdHandle syntax, self-identify, caller targeting
references/windows-workspaces.mdWindow/workspace lifecycle, reorder/move, and context-menu actions (color, description, rename)
references/panes-surfaces.mdSplits, surfaces, move/reorder, focus routing
references/trigger-flash-and-health.mdFlash cue and surface health checks
../cmux-workspace/SKILL.mdCurrent caller workspace rules and non-disruptive automation
../cmux-settings/SKILL.mdSafe cmux.json settings edits and validation
../cmux-browser/SKILL.mdBrowser automation on surface-backed webviews
../cmux-markdown/SKILL.mdMarkdown viewer panel with live file watching

© basicmachines-co, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in .agents/skills/cmux of basicmachines-co/basic-memory.

  • SKILL.md
  • agents/openai.yaml
  • references/handles-and-identify.md
  • references/panes-surfaces.md
  • references/trigger-flash-and-health.md
  • references/windows-workspaces.md

Open the folder on GitHubat commit 6982cfc

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in basicmachines-co/basic-memory, which our catalogue first saw on October 7, 2026.

Compare with similar skills

cmux Window and Pane Control next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

cmux Window and Pane Control compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
cmux Window and Pane Control this skillbasicmachines-co/basic-memory4.1k2 repos~842Automated safety check: PassAGPL-3.0
Skyvern Browser AutomationSkyvern-AI/skyvern23k—~2.9kAutomated safety check: PassAGPL-3.0
Feishu Bitable Managementop7418/CodePilot6.5k1 repos~1.7kAutomated safety check: PassCustom licence
CUAWright Web Task Automationmicrosoft/CUAWright6k—~2kAutomated safety check: NotesMIT
MoviePilot Downloader Operationjxxghp/MoviePilot12k—~4.4kAutomated safety check: PassGPL-3.0
Refly Skill Runnerrefly-ai/refly7.5k—~1.7kAutomated safety check: PassCustom licence

Similar skills

  • Skyvern Browser Automation

    Skyvern-AI/skyvern

    Picks the right Skyvern CLI command for a web task, from quick yes/no checks to reusable multi-page workflows, instead of falling back to plain page fetching.

    23k GitHub stars~2.9k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Creates, queries and edits Feishu Bitable tables through tool calls, covering records, fields, views and batch operations with the correct value format for each field type.

    6.5k GitHub starsUsed in 1 repo~1.7k tokens
    Productivity & AutomationAuto-check passed
  • Official

    Solves web tasks by driving a local Playwright browser one bash command at a time, saving a reusable script, screenshots and an action log for each run.

    6k GitHub stars~2k tokensUpdated yesterday
    Productivity & AutomationAuto-check: notes
  • Inspects, diagnoses and directly controls qBittorrent, Transmission or rTorrent downloaders configured in MoviePilot through a bundled Python helper.

    12k GitHub stars~4.4k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Refly Skill Runner

    refly-ai/refly

    Base skill for the Refly ecosystem: finds, runs and monitors workflow-backed skills through the refly command line, with the actual work done on the Refly backend.

    7.5k GitHub stars~1.7k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • TreeSheets Agent Socket

    aardappel/treesheets

    Runs Lobster scripts against the document open in a running TreeSheets instance through its local agent socket, and returns the results or errors.

    3.2k GitHub stars~5.7k tokensUpdated today
    Productivity & AutomationAuto-check: notes

More from basicmachines-co/basic-memory

All 49 skills in this repo
  • cmux Settings Editor

    basicmachines-co/basic-memory

    Views, sets, unsets and validates cmux settings in ~/.config/cmux/cmux.json with a helper script that checks keys against the schema.

    4.1k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • Cmux Markdown Viewer Panel

    basicmachines-co/basic-memory

    Opens markdown files in a formatted cmux panel beside the terminal that re-renders on every change, handy for plans and task lists.

    4.1k GitHub starsUsed in 2 repos~527 tokens
    Auto-check passed
  • cmux Workspace Scoping

    basicmachines-co/basic-memory

    Keeps agent actions scoped to the cmux workspace and terminal that invoked it, and lays out pane and surface commands that avoid disrupting the user's own focus.

    4.1k GitHub starsUsed in 2 repos~1.7k tokens
    Auto-check passed
  • Basic Memory Repo Images

    basicmachines-co/basic-memory

    Produces PR, changelog and two-week retro images for the Basic Memory repository from evidence in PR bodies, saved to fixed paths under docs/assets/infographics.

    4.1k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Logfire Instrumentation

    basicmachines-co/basic-memory

    Adds Pydantic Logfire tracing, logging and metrics to Python, JavaScript or TypeScript and Rust projects, with the correct setup order and library extras.

    4.1k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Basic Memory Onboarding

    basicmachines-co/basic-memory

    Guides a newcomer to Basic Memory through designing a personal knowledge system, then teaches its use and sets up their assistant to load it each session.

    4.1k GitHub stars~3.4k tokensUpdated today
    Auto-check passed

Questions about cmux Window and Pane Control

How do I install cmux Window and Pane Control in Claude Code?

Run `npx skills add basicmachines-co/basic-memory --skill cmux -a claude-code`. Or copy the skill folder (.agents/skills/cmux in basicmachines-co/basic-memory) into .claude/skills/cmux in your project. Claude Code loads it when a task matches its description.

How do I install cmux Window and Pane Control in Codex?

Run `npx skills add basicmachines-co/basic-memory --skill cmux -a codex`. Or copy the skill folder (.agents/skills/cmux in basicmachines-co/basic-memory) into .agents/skills/cmux in your project. Codex loads it when a task matches its description.

Can I use cmux Window and Pane Control in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add basicmachines-co/basic-memory --skill cmux -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cmux, .gemini/skills/cmux, .github/skills/cmux and .opencode/skills/cmux in your project.

What does cmux Window and Pane Control need to run?

SKILL.md names no scripts, command-line tools or credentials: cmux Window and Pane Control is instructions for the agent only.

Does cmux Window and Pane Control access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is cmux Window and Pane Control safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does cmux Window and Pane Control use?

cmux Window and Pane Control is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does cmux Window and Pane Control use?

About 842 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 831 tokens, read only when the agent opens those files.

What are the alternatives to cmux Window and Pane Control?

Skills that share tags, products or a category with cmux Window and Pane Control: Skyvern Browser Automation (Skyvern-AI/skyvern, 23k stars), Feishu Bitable Management (op7418/CodePilot, 6.5k stars), CUAWright Web Task Automation (microsoft/CUAWright, 6k stars) and MoviePilot Downloader Operation (jxxghp/MoviePilot, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains cmux Window and Pane Control?

basicmachines-co (a GitHub organization) maintains it in basicmachines-co/basic-memory, which has 4,107 GitHub stars. The repository holds 49 skills in this directory. The repository was last updated on October 7, 2026.

Source: basicmachines-co/basic-memory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.