🤖 feat: complete the Mux to Xum rename by matifali · Pull Request #3928 · coder/xum

matifali · 2026-08-22T08:55:58Z

Summary

Complete the remaining Mux → Xum rename across the desktop app, internal TypeScript API, persisted storage, branding assets, VS Code integration, documentation, developer tooling, and Terminal-Bench harness.

What changed

Make ~/.xum and Electron userData/xum canonical while retaining centralized .mux / .cmux migration, read fallback, and downgrade aliases.
Harden migration rollback so data returns to the actual legacy source if compatibility alias creation fails, and align pre-startup home discovery with migration behavior.
Rename project-owned Mux* message, provider, ACP, Gateway/Governor, SSH, and mDNS symbols to Xum* while preserving serialized and wire-level compatibility values.
Replace the Mux-derived icon geometry with a distinct four-ribbon Xum mark and regenerate desktop, tray, favicon, PWA, docs, and VS Code assets.
Make xum canonical in Make targets, logs, service-worker caches, workflows, benchmarks, docs, fixtures, and visible UI; retain explicit compatibility aliases where existing consumers depend on them.
Add make check-xum-branding, backed by a reviewed compatibility allowlist, plus non-writing icon freshness/dimension/content validation.

Compatibility contracts retained

com.mux.app installer identity and mux:// deep links.
mux CLI/npm forwarding package and mux-* release artifacts.
.mux, .cmux, .muxignore, and MUX_* fallback/alias behavior.
VS Code Marketplace/package IDs and persisted mux.* command/settings keys.
Serialized/wire/provider/discovery values including muxMetadata, X-Mux-Workspace-Id, mux-gateway, and _mux-api._tcp.
External endpoints that still use established Mux identities, such as mux.coder.com and ghcr.io/coder/mux.

Validation

make check-xum-branding
bun scripts/generate-icons.ts check
make fmt-check
make lint
make typecheck
Focused compatibility/path/product/protocol/log suites: 93 passed, 5 skipped
Xum transition suite: 28 passed, 5 skipped
Terminal-Bench adapter suite: 24 passed
Trust CLI suite: 5 passed

The full source suite was also exercised: 11,843 passed, 14 skipped, with unrelated environment/global-isolation failures in existing backup/Git, timing, browser, and filesystem tests.

Generated with xum • Model: openai:gpt-5.6-sol • Thinking: high

Replace the reused x-and-cursor icon with a compact four-part convergence mark, regenerate every tracked square branding asset, and add a non-writing freshness and image-validity check to the canonical generator. Validation: - bun scripts/generate-icons.ts update - bun scripts/generate-icons.ts check - make build-icons - make typecheck - make fmt-check - make lint

Make Xum canonical for the Make CLI, Terminal-Bench harness, service-worker cache, local logs, and shared developer environment while preserving explicit legacy aliases and environment inputs. Add a scoped, Make-backed branding audit with behavioral coverage for stale copy and filenames.

mintlify · 2026-08-22T08:56:02Z

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Mux	🟢 Ready	View Preview	Aug 22, 2026, 8:56 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

matifali · 2026-08-22T09:00:12Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:c5043ef444

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

matifali · 2026-08-22T09:09:53Z

@codex review
Please take another look at the latest commit.

matifali · 2026-08-22T09:18:37Z

Addressed all Codex findings in c93dcda:

Updated both BigQuery uploaders to prefer XUM_EXPERIMENTS / XUM_RUN_AS_GOAL by key presence with MUX_* fallback.
Excluded both canonical and pre-rename app/token artifacts from leaderboard submissions.
Made empty canonical benchmark env values explicitly clear legacy aliases and added regression coverage.

Validation: make fmt-check, make lint-actions, make check-bench-agent, uploader precedence checks, and Python compilation.

@codex review

matifali · 2026-08-22T09:22:23Z

Follow-up: the required legacy leaderboard artifact exclusions are now covered by a narrow, documented branding-audit allow rule with regression coverage. make static-check-full passes locally.

@codex review

matifali · 2026-08-22T09:23:42Z

@codex review
Please retry the review; the previous attempt returned an unknown error.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:74edb2682d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

matifali · 2026-08-24T04:37:59Z

Addressed the public package compatibility finding in e199f37 by retaining MuxMessage as a documented alias of canonical XumMessage.

Validated with root typecheck/message suites and the separately published @coder/mux-chat-components package typecheck + production build.

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:e199f37f99

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

matifali · 2026-08-24T04:48:39Z

Addressed the providers-file precedence finding: compatibility env lookups now share one presence-based resolver, so an explicitly empty XUM_PROVIDERS_FILE suppresses a stale MUX_PROVIDERS_FILE. Added regression coverage and validated the branch behavior plus benchmark agent checks.

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:8cac1f7504

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

matifali · 2026-08-24T04:56:05Z

Addressed the repo-root precedence finding: XUM_AGENT_REPO_ROOT now uses the same presence-based compatibility resolver, so an explicit empty canonical value suppresses a stale legacy root and falls back to the checked-in adapter root. Added Harbor-backed regression coverage.

@codex review

matifali · 2026-08-24T04:57:21Z

@codex review
Please retry the review; the previous attempt returned an unknown error. All prior findings are resolved and the latest commit is dfc29c0b0.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:dfc29c0b05

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

matifali · 2026-08-24T05:12:57Z

@codex review
Please review the latest commit dfc29c0b0; all previous findings are fixed and resolved.

matifali · 2026-08-24T05:16:22Z

Addressed the latest Codex findings:

Updated the enabled VS Code chat placeholder to “Message Xum…”.
clearLogFiles() now removes pre-rename mux.log and mux.N.log files alongside canonical rotations, with regression coverage.

Validation: log tests (7 passed), VS Code extension build, root typecheck, formatting, and branding audit.

@codex review

matifali · 2026-08-24T05:17:26Z

Follow-up: the intentional pre-rename log cleanup is now covered by a narrow branding-audit compatibility rule with regression coverage. Local branding/format checks pass.

@codex review

matifali · 2026-08-24T05:20:06Z

Final follow-up: adjusted the legacy log cleanup regression test to use async filesystem APIs. Log tests, lint, and make static-check-full pass locally.

@codex review

matifali · 2026-08-24T05:27:20Z

@codex review
Please provide the final code review for commit 5677ce54e; all review threads are resolved and local validation is green.

matifali · 2026-08-24T05:35:08Z

@codex review
All findings are addressed and all required CI checks pass. Please provide the final code-review decision for commit 5677ce54e.

matifali · 2026-08-24T05:51:31Z

@codex review

matifali added 6 commits August 22, 2026 12:44

fix: harden xum directory transition
b225df8

refactor: rename internal Mux identifiers to Xum
fad2050

docs: finish visible Xum branding
77e91db

test: use canonical Xum trust paths
6a47e86

mintlifyBotdeployed to staging - docs August 22, 2026 08:56 View deployment

matifali added 2 commits August 22, 2026 13:57

chore: use exec form for Docker healthcheck
4a6489f

fix: export benchmark compatibility variables
c5043ef