# Cmux Localization

Localization rules and audit workflow for cmux UI strings, settings rows, menus...

- Repository: https://github.com/manaflow-ai/cmux (28635 stars)
- Category: Design
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add manaflow-ai/cmux --skill cmux-localization -g -a claude-code -y`
Codex: `npx skills add manaflow-ai/cmux --skill cmux-localization -g -a codex -y`
Cursor: `npx skills add manaflow-ai/cmux --skill cmux-localization -g -a cursor -y`
Gemini CLI: `npx skills add manaflow-ai/cmux --skill cmux-localization -g -a gemini-cli -y`

## Description

Localization rules and audit workflow for cmux UI strings, settings rows, menus, shortcuts, schema/config text, docs, command/help text, alerts, tooltips, and web messages. Use whenever changing user-facing text.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# cmux Localization

Use this skill for any user-facing string change.

## Normal contributor flow

After adding or changing user-facing copy, run `./scripts/localize-changes`.

The command compares the current worktree with the mainline base, discovers changed Swift localization keys and English web messages, prepares simple new or changed macOS catalog entries with minimal edits, and writes a machine-readable translation packet under git metadata. Fill `value` for simple translations or `localization` for plural or variant entries, then run the same command again. When an existing translation is still correct after an English change, fill `value` with that same text; the packet remembers the confirmation so later runs do not mark it for review again. Completed macOS rows are imported through `scripts/localization_catalog.py merge`, and `scripts/localization_catalog.py check` remains the final authoritative validator.

Use `--base <ref>` for another comparison base and `--work-file <path>` when a translation helper needs a visible packet. The default packet stays outside the worktree. Ambiguous catalog ownership, a key whose Swift call sites (changed or not) disagree on `defaultValue`, count-like new strings, unsupported Swift literal forms, and invalid generated translations stop with a concrete human-attention item so the existing placeholder, plural, bidi, omission, identity-translation, copied-English, and catalog checks stay intact.

## Hard rules

The rest: https://github.com/manaflow-ai/cmux/blob/HEAD/skills/cmux-localization/SKILL.md