New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

cmux Settings Editor

by manaflow-ai in 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.

Custom licenceAuto-check passedProductivity & Automation

Install cmux Settings Editor

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

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

GitHub CLI
$ gh skill install manaflow-ai/cmux cmux-settings --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-settings .claude/skills/cmux-settings && 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-settings
GitHub stars
28k
Token cost
~2.3k tokens
SKILL.md length
947 words
Files
7 (incl. scripts, references)
Skills in repo
22
Repo updated
First seen
Licence
Custom licence

At a glance

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.

  • Works in 4 steps: Look up the key when the user named a… → Set it. JSON literals must be valid JSON. → Read back and cmux-settings validate. → …
  • Changing a cmux preference by JSON path
  • SKILL.md covers Helper script, Workflow, Viewer settings and Reversible changes, plus 2 more sections
  • Runs Python scripts from its folder; calls rg

What it does

cmux reads its settings from a JSONC file at `~/.config/cmux/cmux.json`, and a watcher applies changes when the file is saved, with no restart. An older `settings.json` is read only as a fallback for keys missing from the new file. Settings sections include app, terminal, notifications, sidebar, browser, markdown, file editor, file explorer, diff viewer and shortcuts, and some non-settings sections such as actions and commands share the same file.

All reads and writes go through the bundled `cmux-settings` helper. It supports commands such as `path`, `dump` (with or without comments), `get` for a dotted JSON path and `set` for a value parsed as JSON, validates the whole proposed document with `cmux config validate` before writing, and writes atomically unless the change would add a new validation issue. Existing issues, such as a key from a newer cmux, do not block unrelated edits. Lists of every recognized key and of shortcut actions are bundled as references, and the agent is told not to invent a `templates` path for viewers because the published schema is authoritative.

When your agent uses it

  • Changing a cmux preference by JSON path
  • Looking up which keys cmux recognizes
  • Rebinding a cmux keyboard shortcut
  • Validating cmux.json after a hand edit

Example prompts

  • “Rebind the shortcut for splitting a pane in cmux.”
  • “Show me the current cmux terminal settings.”
  • “Validate my cmux.json and tell me which keys are not recognized.”

Requirements

  • cmux, including its `cmux config validate` command
  • Python, for the bundled JSONC editing helper

Workflow steps

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

  1. Look up the key when the user named a setting in plain English
  2. Set it. JSON literals must be valid JSON.
  3. Read back and cmux-settings validate.
  4. Tell the user it auto-reloaded, and that cmux-settings unset reverts it.

What it can do on your machine

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

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • rg

    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 Settings Editor loads about 2.3k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 121 tokens; SKILL.md has 947 words of instructions outside code blocks.

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

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); the scripts in this folder 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 947 words (~2,312 tokens).

“cmux reads user settings from ~/.config/cmux/cmux.json (JSONC). A file watcher applies changes on save, no restart. Legacy ~/.config/cmux/settings.json is read only as a fallback for keys absent from cmux.json.”

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

Read the full SKILL.md on GitHub

Files

SKILL.md and 6 other files (scripts, references) in skills/cmux-settings of manaflow-ai/cmux.

  • SKILL.md
  • agents/openai.yaml
  • references/all-keys.md
  • references/shortcut-actions.md
  • scripts/cmux-settings
  • scripts/cmux_jsonc_edit.py
  • scripts/config_mutation_messages.json

Open the folder on GitHubat commit bbb3633

Compare with similar skills

cmux Settings Editor 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 Settings Editor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
cmux Settings Editor this skillmanaflow-ai/cmux28k—~2.3kAutomated safety check: PassCustom licence
Disk Storage AnalyzerKKKKhazix/khazix-skills21k1 repos~1.4kAutomated safety check: PassMIT
TreeSheets Agent Socketaardappel/treesheets3.2k—~5.7kAutomated safety check: NotesZlib
Open Computer UseiFurySt/open-codex-computer-use2.4k—~1.5kAutomated safety check: PassMIT
Mac Computer UseTo3akaRin/mac-computer-use1.1k—~495Automated safety check: PassMIT
Peon-Ping Settings EditorPeonPing/peon-ping5.1k—~1.2kAutomated safety check: PassMIT

Similar skills

  • Disk Storage Analyzer

    KKKKhazix/khazix-skills

    Scans a Mac or Windows PC read-only to find what fills the disk, grades each item by how safe it is to clean and builds an interactive HTML report.

    21k GitHub starsUsed in 1 repo~1.4k tokens
    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 yesterday
    Productivity & AutomationAuto-check: notes

  • 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 today
    Productivity & AutomationAuto-check passed

  • Mac Computer Use

    To3akaRin/mac-computer-use

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

    1.1k GitHub stars~495 tokensUpdated 17 days ago
    Productivity & AutomationAuto-check passed

  • Peon-Ping Settings Editor

    PeonPing/peon-ping

    Edits the peon-ping config file to change volume, sound packs, pack rotation, sound categories and notification options, then confirms the change.

    5.1k GitHub stars~1.2k tokensUpdated 4 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 6 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 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

  • Ghostty Submodule and GhosttyKit Workflow

    manaflow-ai/cmux

    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

  • cmux Browser Surface Control

    manaflow-ai/cmux

    Opens, inspects, and drives a browser surface through the cmux CLI without stealing the user's focus, always targeting an explicit surface handle.

    28k GitHub stars~2.7k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about cmux Settings Editor

What does cmux Settings Editor do?

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. json`, and a watcher applies changes when the file is saved, with no restart.json` is read only as a fallback for keys missing from the new file.

When should I use cmux Settings Editor?

cmux Settings Editor fits situations like: changing a cmux preference by JSON path; looking up which keys cmux recognizes; rebinding a cmux keyboard shortcut; validating cmux.json after a hand edit.

How do I install cmux Settings Editor in Claude Code?

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

How do I install cmux Settings Editor in Codex?

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

Can I use cmux Settings Editor 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-settings -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-settings, .gemini/skills/cmux-settings, .github/skills/cmux-settings and .opencode/skills/cmux-settings in your project.

What does cmux Settings Editor need to run?

Going by SKILL.md and its folder, cmux Settings Editor needs Python for the scripts in its folder and the command-line tools its instructions call (rg). Our summary lists: cmux, including its `cmux config validate` command; Python, for the bundled JSONC editing helper.

Does cmux Settings Editor 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 Settings Editor 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does cmux Settings Editor use?

cmux Settings Editor 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 Settings Editor use?

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

What are the alternatives to cmux Settings Editor?

Skills that share tags, products or a category with cmux Settings Editor: Disk Storage Analyzer (KKKKhazix/khazix-skills, 21k stars), TreeSheets Agent Socket (aardappel/treesheets, 3.2k stars), Open Computer Use (iFurySt/open-codex-computer-use, 2.4k stars) and Mac Computer Use (To3akaRin/mac-computer-use, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains cmux Settings Editor?

manaflow-ai (a GitHub organization) maintains it in manaflow-ai/cmux, which has 28,076 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 10, 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.