chore: rename wmdev to webmux (#74)

Rename the npm package and CLI binary from `wmdev` to `webmux`.
Updates all references across source files, configs, docs, and
build scripts. The upstream `workmux` name is unchanged.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: centdix

.gitignore

@@ -6,7 +6,7 @@ frontend/node_modules/
 frontend/bun.lock
 backend/dist/
 frontend/dist/
-bin/wmdev.js
+bin/webmux.js
 frontend/.vite/
 public/
 .env

.wmdev.yaml .webmux.yaml.wmdev.yaml renamed to .webmux.yaml

@@ -11,7 +11,7 @@
 
 ### Bug Fixes
 
-* comment out services section in wmdev template ([3967301](https://github.com/windmill-labs/webmux/commit/3967301fd4b6c2fe8b8b069b7e1b19991a86fdcb))
+* comment out services section in webmux template ([3967301](https://github.com/windmill-labs/webmux/commit/3967301fd4b6c2fe8b8b069b7e1b19991a86fdcb))
 
 ## [0.6.2](https://github.com/windmill-labs/webmux/compare/v0.6.1...v0.6.2) (2026-03-04)
 
@@ -32,8 +32,8 @@
 
 ### Features
 
-* add `wmdev init` onboarding command ([#65](https://github.com/windmill-labs/webmux/issues/65)) ([6e8b128](https://github.com/windmill-labs/webmux/commit/6e8b128785d716bf38cd1a3ea0d45f9837941ec3))
-* add `wmdev service` command for running as a system daemon ([#67](https://github.com/windmill-labs/webmux/issues/67)) ([39ba997](https://github.com/windmill-labs/webmux/commit/39ba99704482ea5bfb8567a632b741df3e6bb623))
+* add `webmux init` onboarding command ([#65](https://github.com/windmill-labs/webmux/issues/65)) ([6e8b128](https://github.com/windmill-labs/webmux/commit/6e8b128785d716bf38cd1a3ea0d45f9837941ec3))
+* add `webmux service` command for running as a system daemon ([#67](https://github.com/windmill-labs/webmux/issues/67)) ([39ba997](https://github.com/windmill-labs/webmux/commit/39ba99704482ea5bfb8567a632b741df3e6bb623))
 * extract StartupEnvFields component ([#66](https://github.com/windmill-labs/webmux/issues/66)) ([6a2206d](https://github.com/windmill-labs/webmux/commit/6a2206d53183bcf5f307bb3d919aa6484caef55f))
 * rate-limit mitigation for GitHub API calls ([#69](https://github.com/windmill-labs/webmux/issues/69)) ([efb4b4a](https://github.com/windmill-labs/webmux/commit/efb4b4a46154842e6ef5e13320f08710d2f76707))
 * render checkbox for boolean startupEnvs, omit unchecked from env ([e274b3b](https://github.com/windmill-labs/webmux/commit/e274b3bc472e60748bd0d389aa08b2230e8918ac))
@@ -122,8 +122,8 @@
 
 ### Features
 
-* add debug log levels with --debug flag for wmdev ([331ed1a](https://github.com/windmill-labs/workmux-web/commit/331ed1a0445869c2d187a872f61a532c52315227))
-* move port allocation into wmdev backend ([#34](https://github.com/windmill-labs/workmux-web/issues/34)) ([ade42fd](https://github.com/windmill-labs/workmux-web/commit/ade42fddecb27b350c548cc2c3146014ccf4b340))
+* add debug log levels with --debug flag for webmux ([331ed1a](https://github.com/windmill-labs/workmux-web/commit/331ed1a0445869c2d187a872f61a532c52315227))
+* move port allocation into webmux backend ([#34](https://github.com/windmill-labs/workmux-web/issues/34)) ([ade42fd](https://github.com/windmill-labs/workmux-web/commit/ade42fddecb27b350c548cc2c3146014ccf4b340))
 
 
 ### Bug Fixes

CHANGELOG.md

@@ -1,6 +1,6 @@
-# wmdev
+# webmux
 
-A web dashboard for managing parallel AI coding agents. Built on top of [workmux](https://github.com/raine/workmux), which handles git worktrees and tmux orchestration — wmdev adds a browser UI with embedded terminals, live status tracking, and CI integration.
+A web dashboard for managing parallel AI coding agents. Built on top of [workmux](https://github.com/raine/workmux), which handles git worktrees and tmux orchestration — webmux adds a browser UI with embedded terminals, live status tracking, and CI integration.
 
 https://github.com/user-attachments/assets/48c9564f-42a5-404f-97e2-c5ee0138f15d
 
@@ -10,7 +10,7 @@ https://github.com/user-attachments/assets/48c9564f-42a5-404f-97e2-c5ee0138f15d
 
 ![createanddelete-1 5x](https://github.com/user-attachments/assets/7f084d27-448c-47e4-aadf-8ab25154c096)
 
-Spin up new worktrees with one click. Pick a profile, type a prompt, and wmdev creates the worktree, starts the agent, and begins streaming output. Merge or remove worktrees when you're done.
+Spin up new worktrees with one click. Pick a profile, type a prompt, and webmux creates the worktree, starts the agent, and begins streaming output. Merge or remove worktrees when you're done.
 
 ### Embedded Terminals
 
@@ -26,13 +26,13 @@ See pull request status, CI check results, and review comments right next to eac
 
 ![monitor-1 5x](https://github.com/user-attachments/assets/b2cf535a-0242-4c15-bdb9-344dfde5f75e)
 
-Track dev server ports across worktrees. wmdev polls configured services and shows live health badges so you know which worktrees have their servers running.
+Track dev server ports across worktrees. webmux polls configured services and shows live health badges so you know which worktrees have their servers running.
 
 ### Docker Sandbox Mode
 
 <!-- gif -->
 
-Run agents in isolated Docker containers for untrusted or experimental work. wmdev manages the container lifecycle, port forwarding, and volume mounts automatically.
+Run agents in isolated Docker containers for untrusted or experimental work. webmux manages the container lifecycle, port forwarding, and volume mounts automatically.
 
 ## Quick Start
 
@@ -42,15 +42,15 @@ cargo install workmux          # or: brew install raine/workmux/workmux
 sudo apt install tmux           # or: brew install tmux
 curl -fsSL https://bun.sh/install | bash
 
-# 2. Install wmdev
-bun install -g wmdev
+# 2. Install webmux
+bun install -g webmux
 
 # 3. Set up your project
 cd /path/to/your/project
-wmdev init                     # creates .workmux.yaml and .wmdev.yaml
+webmux init                     # creates .workmux.yaml and .webmux.yaml
 
 # 4. Start the dashboard
-wmdev                          # opens on http://localhost:5111
+webmux                          # opens on http://localhost:5111
 ```
 
 ## Prerequisites
@@ -66,13 +66,13 @@ wmdev                          # opens on http://localhost:5111
 
 ## Configuration
 
-wmdev uses two config files in the project root:
+webmux uses two config files in the project root:
 
 - **`.workmux.yaml`** — Controls worktree directory, pane layout, agent selection, and lifecycle hooks. See the [workmux docs](https://github.com/raine/workmux).
-- **`.wmdev.yaml`** — Dashboard-specific config: service health checks, profiles, linked repos, and Docker sandbox settings.
+- **`.webmux.yaml`** — Dashboard-specific config: service health checks, profiles, linked repos, and Docker sandbox settings.
 
 <details>
-<summary><strong>.wmdev.yaml example</strong></summary>
+<summary><strong>.webmux.yaml example</strong></summary>
 
 ```yaml
 name: My Project
@@ -113,7 +113,7 @@ linkedRepos:
 </details>
 
 <details>
-<summary><strong>.wmdev.yaml full schema</strong></summary>
+<summary><strong>.webmux.yaml full schema</strong></summary>
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|

README.md

@@ -1,5 +1,5 @@
 {
-  "name": "wmdev-backend",
+  "name": "webmux-backend",
   "private": true,
   "type": "module",
   "scripts": {

backend/package.json

@@ -24,7 +24,7 @@ export interface LinkedRepoConfig {
   alias: string;
 }
 
-export interface WmdevConfig {
+export interface WebmuxConfig {
   name?: string;
   services: ServiceConfig[];
   profiles: {
@@ -36,7 +36,7 @@ export interface WmdevConfig {
   startupEnvs: Record<string, string | boolean>;
 }
 
-const DEFAULT_CONFIG: WmdevConfig = {
+const DEFAULT_CONFIG: WebmuxConfig = {
   services: [],
   profiles: { default: { name: "default" } },
   autoName: false,
@@ -65,11 +65,11 @@ export function gitRoot(dir: string): string {
   return new TextDecoder().decode(result.stdout).trim() || dir;
 }
 
-/** Load .wmdev.yaml from the git root, merging with defaults. */
-export function loadConfig(dir: string): WmdevConfig {
+/** Load .webmux.yaml from the git root, merging with defaults. */
+export function loadConfig(dir: string): WebmuxConfig {
   try {
     const root = gitRoot(dir);
-    const filePath = join(root, ".wmdev.yaml");
+    const filePath = join(root, ".webmux.yaml");
     const result = Bun.spawnSync(["cat", filePath], { stdout: "pipe" });
     const text = new TextDecoder().decode(result.stdout).trim();
     if (!text) return DEFAULT_CONFIG;

backend/src/config.ts

@@ -1,4 +1,4 @@
-const DEBUG = Bun.env.WMDEV_DEBUG === "1";
+const DEBUG = Bun.env.WEBMUX_DEBUG === "1";
 
 function ts(): string {
   return new Date().toISOString().slice(11, 23);

backend/src/lib/log.ts

@@ -27,17 +27,17 @@ import {
   clearCallbacks,
   cleanupStaleSessions,
 } from "./terminal";
-import { loadConfig, gitRoot, type WmdevConfig } from "./config";
+import { loadConfig, gitRoot, type WebmuxConfig } from "./config";
 import { startPrMonitor, type PrEntry } from "./pr";
 import { handleWorkmuxRpc } from "./rpc";
 import { jsonResponse, errorResponse } from "./http";
 import { handleNotificationStream, handleDismissNotification, installHookScripts, hasDashboardActivity, touchActivity } from "./notifications";
 import { fetchAssignedIssues, branchMatchesIssue, type LinkedLinearIssue } from "./linear";
 
 const PORT = parseInt(Bun.env.BACKEND_PORT || "5111", 10);
-const STATIC_DIR = Bun.env.WMDEV_STATIC_DIR || "";
-const PROJECT_DIR = Bun.env.WMDEV_PROJECT_DIR || gitRoot(process.cwd());
-const config: WmdevConfig = loadConfig(PROJECT_DIR);
+const STATIC_DIR = Bun.env.WEBMUX_STATIC_DIR || "";
+const PROJECT_DIR = Bun.env.WEBMUX_PROJECT_DIR || gitRoot(process.cwd());
+const config: WebmuxConfig = loadConfig(PROJECT_DIR);
 
 // --- Worktree list cache (short TTL to deduplicate rapid polls) ---
 const WORKTREE_CACHE_TTL_MS = 2000;

backend/src/server.ts

@@ -38,11 +38,11 @@ function checkDeps(): Dep[] {
   return missing;
 }
 
-function wmdevTemplate(name: string): string {
+function webmuxTemplate(name: string): string {
   return `# Project display name in the dashboard
 name: ${name}
 
-# Each service defines a port env var that wmdev injects into .env.local
+# Each service defines a port env var that webmux injects into .env.local
 # when creating a worktree. Ports are auto-assigned: base + (slot × step).
 # Use \`source .env.local\` in your .workmux.yaml pane commands to pick them up.
 services:
@@ -96,7 +96,7 @@ panes:
       To restart dev server: tmux send-keys -t .1 C-c 'source .env.local && PORT=\\$PORT npm run dev' Enter"
     focus: true
 
-  # Dev server — waits for .env.local (written by wmdev) then starts
+  # Dev server — waits for .env.local (written by webmux) then starts
   - command: >-
       npm install &&
       until [ -f .env.local ]; do sleep 0.2; done;
@@ -108,7 +108,7 @@ panes:
 
 // ── Main ─────────────────────────────────────────────────────────────────────
 
-p.intro("wmdev init");
+p.intro("webmux init");
 
 // Step 1 — Git repo
 const gitRoot = getGitRoot();
@@ -126,7 +126,7 @@ const missing = checkDeps();
 
 if (missing.length > 0) {
   const lines = missing.map((d) => `  ${d.tool}: ${d.hint}`).join("\n");
-  p.note(lines, "Install these required dependencies, then re-run wmdev init");
+  p.note(lines, "Install these required dependencies, then re-run webmux init");
   p.outro("Setup incomplete.");
   process.exit(1);
 }
@@ -152,20 +152,20 @@ if (existsSync(workmuxYaml)) {
   p.log.success(".workmux.yaml created");
 }
 
-// Step 5 — .wmdev.yaml
-const wmdevYaml = join(gitRoot, ".wmdev.yaml");
-if (existsSync(wmdevYaml)) {
-  p.log.info(".wmdev.yaml already exists, skipping");
+// Step 5 — .webmux.yaml
+const webmuxYaml = join(gitRoot, ".webmux.yaml");
+if (existsSync(webmuxYaml)) {
+  p.log.info(".webmux.yaml already exists, skipping");
 } else {
   const name = detectProjectName(gitRoot);
-  await Bun.write(wmdevYaml, wmdevTemplate(name));
-  p.log.success(".wmdev.yaml created");
+  await Bun.write(webmuxYaml, webmuxTemplate(name));
+  p.log.success(".webmux.yaml created");
 }
 
 // Step 6 — Summary
 p.outro("You're all set! Next steps:");
 console.log();
 console.log("  1. Edit .workmux.yaml to configure pane layout for your project");
-console.log("  2. Edit .wmdev.yaml to set up service ports and profiles");
-console.log("  3. Run: wmdev");
+console.log("  2. Edit .webmux.yaml to set up service ports and profiles");
+console.log("  3. Run: webmux");
 console.log();