Agent skill

cmux Customization

by manaflow-ai in manaflow-ai/cmux

Edits cmux settings, custom actions, workspace layouts, Dock controls and viewer options safely, keeping the user's config intact and validating changes first.

Custom licenceAuto-check passedProductivity & Automation

Install cmux Customization

skills CLI
$ npx skills add manaflow-ai/cmux --skill cmux-customization -a claude-code

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

GitHub CLI
$ gh skill install manaflow-ai/cmux cmux-customization --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/manaflow-ai/cmux.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cmux-customization .claude/skills/cmux-customization && 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-customization
GitHub stars
28k
Token cost
~1.7k tokens
SKILL.md length
702 words
Files
4 (incl. references)
Skills in repo
22
Repo updated
First seen
Licence
Custom licence

At a glance

Edits cmux settings, custom actions, workspace layouts, Dock controls and viewer options safely, keeping the user's config intact and validating changes first.

  • Works in 7 steps: Inspect existing config. → Pick global or project-local scope.… → Back up the target file when it already… → …
  • Adding a custom action or command to the cmux Command Palette
  • SKILL.md covers Choose the right surface, Workflow, Example: Command Palette action and Validation, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The first move is picking the right surface for a request: app preferences in the global cmux.json, custom actions, layouts, tab bar buttons, plus-button behavior and Command Palette entries in global or project-local cmux.json, Dock controls in dock.json, terminal rendering in the Ghostty config, and workspace names and colors through the cmux CLI. If Ghostty config can handle a request, the agent says so instead of inventing cmux settings.

Edits follow the schema, leave existing config intact and are validated before the agent reports completion. Project-local files let layouts and commands travel with a repo and override global entries with the same ID. Viewer settings for the browser, Markdown, file editor, file explorer and diff viewer live in the global file, with a viewer matrix and examples as references, and cmux import can bring fonts and colors over from iTerm2, Kitty, WezTerm and other terminals after a dry run.

When your agent uses it

  • Adding a custom action or command to the cmux Command Palette
  • Setting up a project-specific workspace layout in .cmux/cmux.json
  • Configuring Dock panels for logs or test watchers
  • Importing terminal settings from iTerm2 or Kitty

Example prompts

  • “Add a cmux action that opens a split with the dev server and a test watcher.”
  • “Move my fonts and colors from iTerm2 into cmux, and preview the import first.”
  • “Put a git TUI in the right sidebar Dock for this project.”

Requirements

  • cmux installed on macOS

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Inspect existing config.
  2. Pick global or project-local scope. Default to project-local for repo-specific commands, global for app preferences. Ask only when the…
  3. Back up the target file when it already exists (applicable path only, no backup for a missing file).
  4. For app settings and cmux-owned shortcuts, use the settings helper (~/.codex/skills/... if the user installed with skills.sh).
  5. For actions, UI wiring, workspace layouts, notification hooks, and Dock controls, edit the JSONC by hand and preserve unrelated sections…
  6. cmux reload-config.
  7. Verify the configured entrypoint exists: read back the shortcut binding, or confirm the action ID and where it should appear.

What it can do on your machine

Read from SKILL.md and the folder at commit f6532b1. 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 and json).

    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 Customization loads about 1.7k tokens when it runs, and up to ~4.5k if it reads all its reference files. Until then it costs about 111 tokens; SKILL.md has 702 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 702 words (~1,749 tokens).

“Keep the user's config intact, prefer schema-backed edits, and validate before reporting completion.”

— opening of SKILL.md by manaflow-ai, Custom licence
name
cmux-customization

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (references) in skills/cmux-customization of manaflow-ai/cmux.

  • SKILL.md
  • agents/openai.yaml
  • references/examples.md
  • references/viewer-types.md

Open the folder on GitHubat commit f6532b1

Compare with similar skills

cmux Customization 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 Customization compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
cmux Customization this skillmanaflow-ai/cmux28k—~1.7kAutomated safety check: PassCustom licence
Open Computer UseiFurySt/open-codex-computer-use2.4k—~1.5kAutomated safety check: PassMIT
Mac Computer UseTo3akaRin/mac-computer-use1.1k—~495Automated safety check: PassMIT
Yichen Mac Wechat Dual Openmcncarl/yichen-skills4.4k—~1.5kAutomated safety check: PassCustom licence
Feishu BridgeAlexAnys/feishu-openclaw3171 repos~615Automated safety check: PassNone
Shortcuts Generatordrewocarr/generate-shortcuts-skill2181 repos~2kAutomated safety check: NotesNone

Similar skills

  • Open Computer Use

    iFurySt/open-codex-computer-use

    Platform-neutral guidance for using Open Computer Use, the open-source Computer Use MCP server and CLI for macOS, Linux, and Windows.

    2.4k GitHub stars~1.5k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed
  • Mac Computer Use

    To3akaRin/mac-computer-use

    操作 macOS 桌面应用,探测窗口和自动化接口、截图、读取或修改辅助功能元素、执行鼠标键盘动作,以及通过 CDP 操作内嵌 Chromium 页面。适用于桌面应用自动化与界面验收;普通网页任务优先使用已有浏览器工具。

    1.1k GitHub stars~495 tokensUpdated 15 days ago
    Productivity & AutomationAuto-check passed
  • Yichen Mac Wechat Dual Open

    mcncarl/yichen-skills

    Create, inspect, repair, and polish a second WeChat app on macOS by copying WeChat, changing the bundle identifier, ad-hoc re-signing, preparing it for the user to open manually, setting Chinese…

    4.4k GitHub stars~1.5k tokensUpdated 5 days ago
    Productivity & AutomationAuto-check passed
  • Feishu Bridge

    AlexAnys/feishu-openclaw

    Connect a Feishu (Lark) bot to Clawdbot via WebSocket long-connection.

    317 GitHub starsUsed in 1 repo~615 tokens
    Productivity & AutomationAuto-check passed
  • Shortcuts Generator

    drewocarr/generate-shortcuts-skill

    Generate macOS/iOS Shortcuts by creating plist files. An agent skill from drewocarr/generate-shortcuts-skill.

    218 GitHub starsUsed in 1 repo~2k tokens
    Productivity & AutomationAuto-check: notes
  • Control local macOS, Windows, and Linux apps through Waku Computer Use.

    1.6k GitHub stars~3.6k tokensUpdated 7 days ago
    Productivity & AutomationAuto-check passed

More from manaflow-ai/cmux

All 22 skills in this repo
  • cmux Diagnostics

    manaflow-ai/cmux

    Runs a read-only health check for cmux and explains what it finds, covering the CLI and socket, settings, agent hooks, session restore and notifications.

    28k GitHub starsUsed in 1 repo~819 tokens
    Auto-check passed
  • cmux Settings Editor

    manaflow-ai/cmux

    Reads and changes cmux preferences in `~/.config/cmux/cmux.json` through a helper that validates each change before writing, covering terminal, browser, viewers and shortcuts.

    28k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • cmux Backend Rules

    manaflow-ai/cmux

    Sets the backend TypeScript and Cloud VM rules for cmux: Effect-based services, thin route handlers, Postgres as source of truth, migrations and provider secrets.

    28k GitHub starsUsed in 1 repo~682 tokens
    Auto-check passed
  • Cmux Debugging Guide

    manaflow-ai/cmux

    Covers debug logging, the Debug menu, profiling rules and runtime pitfalls for working on the cmux macOS terminal app.

    28k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Workflow rules for the Ghostty submodule in cmux: rebuilding GhosttyKit.xcframework, pushing fork changes and updating the parent submodule pointer safely.

    28k GitHub starsUsed in 1 repo~580 tokens
    Auto-check passed
  • Cmux Release Workflow

    manaflow-ai/cmux

    Runs the cmux release process: gathers per-PR changelog lines since the last tag, bumps the version, guards against a bad tag, then tags and pushes the macOS DMG release.

    28k GitHub starsUsed in 1 repo~856 tokens
    Auto-check passed

Works with

Questions about cmux Customization

What does cmux Customization do?

Edits cmux settings, custom actions, workspace layouts, Dock controls and viewer options safely, keeping the user's config intact and validating changes first. json, terminal rendering in the Ghostty config, and workspace names and colors through the cmux CLI. If Ghostty config can handle a request, the agent says so instead of inventing cmux settings.

When should I use cmux Customization?

cmux Customization fits situations like: adding a custom action or command to the cmux Command Palette; setting up a project-specific workspace layout in .cmux/cmux.json; configuring Dock panels for logs or test watchers; importing terminal settings from iTerm2 or Kitty.

How do I install cmux Customization in Claude Code?

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

How do I install cmux Customization in Codex?

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

Can I use cmux Customization 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 manaflow-ai/cmux --skill cmux-customization -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-customization, .gemini/skills/cmux-customization, .github/skills/cmux-customization and .opencode/skills/cmux-customization in your project.

What does cmux Customization need to run?

SKILL.md names no scripts, command-line tools or credentials: cmux Customization is instructions for the agent only. Our summary lists: cmux installed on macOS.

Does cmux Customization 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 Customization 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 Customization use?

cmux Customization has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does cmux Customization use?

About 1.7k tokens (SKILL.md is roughly 7k 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 2.7k tokens, read only when the agent opens those files.

What are the alternatives to cmux Customization?

Skills that share tags, products or a category with cmux Customization: Open Computer Use (iFurySt/open-codex-computer-use, 2.4k stars), Mac Computer Use (To3akaRin/mac-computer-use, 1.1k stars), Yichen Mac Wechat Dual Open (mcncarl/yichen-skills, 4.4k stars) and Feishu Bridge (AlexAnys/feishu-openclaw, 317 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains cmux Customization?

manaflow-ai (a GitHub organization) maintains it in manaflow-ai/cmux, which has 28,044 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 9, 2026.

Source: manaflow-ai/cmux on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.