fix: enable windows builds

fix: improved windows compatibility

🤖 fix: publish Windows .exe in release workflow\n\n- Add Windows job to build and publish NSIS .exe\n- Install ImageMagick on Windows in setup-cmux action\n- Set Windows icon and artifactName in electron-builder config\n\n_Generated with _

fix: chalk tests improvements

fix: codex review

WIP

🤖 feat: add unified cross-platform path utilities for Windows compatibility

- Created PlatformPaths utility class for OS-aware path operations
- Added UI-specific path formatting utilities for renderer process
- Updated all path handling to use centralized utilities
- Refactored pathAbbreviation to support Windows paths (C:\U\j\D\project)
- Updated components: ProjectSidebar, NewWorkspaceModal, SecretsModal
- Updated config.ts to use PlatformPaths for project name extraction
- Eliminated 6+ instances of duplicated path splitting logic
- Added comprehensive test suite (33 tests, all passing)
- Added src/utils/platform/ to ESLint main-process exclusions

This change prepares cmux for Windows support by centralizing all path
operations into platform-aware utilities, ensuring correct behavior on
Windows, macOS, and Linux.

WIP

fix: path cleanup

fix: fmt

fix: tests & fmt

fix: exclude heavy dirs from watch

fix: ssh workdir

fix: test

WIP

fix: fmt

Author: ibetitsmike

.github/actions/setup-cmux/action.yml

@@ -62,3 +62,14 @@ runs:
           sudo apt-get install -y --no-install-recommends imagemagick
         fi
         convert --version | head -1
+    - name: Install ImageMagick (Windows)
+      if: inputs.install-imagemagick == 'true' && runner.os == 'Windows'
+      shell: powershell
+      run: |
+        if (Get-Command magick -ErrorAction SilentlyContinue) {
+          Write-Host "✅ ImageMagick already available"
+        } else {
+          Write-Host "📦 Installing ImageMagick..."
+          choco install -y imagemagick
+        }
+        magick --version | Select-Object -First 1

.github/workflows/release.yml

@@ -58,3 +58,34 @@ jobs:
         run: bun x electron-builder --linux --publish always
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  build-windows:
+    name: Build and Release Windows
+    runs-on: windows-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Required for git describe to find tags
+
+      - uses: ./.github/actions/setup-cmux
+        with:
+          install-imagemagick: true
+
+      - name: Install GNU Make (for build)
+        run: choco install -y make
+
+      - name: Verify tools
+        shell: bash
+        run: |
+          make --version
+          bun --version
+          magick --version | head -1
+
+      - name: Build application
+        run: bun run build
+
+      - name: Package and publish for Windows (.exe)
+        run: bun x electron-builder --win --publish always
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Makefile

@@ -24,6 +24,15 @@
 #   Branches reduce reproducibility - builds should fail fast with clear errors
 #   if dependencies are missing, not silently fall back to different behavior.
 
+# Use PATH-resolved bash on Windows to avoid hardcoded /usr/bin/bash which doesn't
+# exist in Chocolatey's make environment or on GitHub Actions windows-latest.
+ifeq ($(OS),Windows_NT)
+SHELL := bash
+else
+SHELL := /bin/bash
+endif
+.SHELLFLAGS := -eu -o pipefail -c
+
 # Enable parallel execution by default (only if user didn't specify -j)
 ifeq (,$(filter -j%,$(MAKEFLAGS)))
 MAKEFLAGS += -j
@@ -92,8 +101,9 @@ help: ## Show this help message
 
 ## Development
 dev: node_modules/.installed build-main ## Start development server (Vite + tsgo watcher for 10x faster type checking)
-	@bun x concurrently -k \
-		"bun x concurrently \"$(TSGO) -w -p tsconfig.main.json\" \"bun x tsc-alias -w -p tsconfig.main.json\"" \
+	@npx concurrently -k --raw \
+		"$(TSGO) -w -p tsconfig.main.json" \
+		"bun x tsc-alias -w -p tsconfig.main.json" \
 		"vite"
 
 dev-server: node_modules/.installed build-main ## Start server mode with hot reload (backend :3000 + frontend :5173). Use VITE_HOST=0.0.0.0 BACKEND_HOST=0.0.0.0 for remote access
@@ -102,10 +112,10 @@ dev-server: node_modules/.installed build-main ## Start server mode with hot rel
 	@echo "  Frontend (with HMR):     http://$(or $(VITE_HOST),localhost):$(or $(VITE_PORT),5173)"
 	@echo ""
 	@echo "For remote access: make dev-server VITE_HOST=0.0.0.0 BACKEND_HOST=0.0.0.0"
-	@bun x concurrently -k \
-		"bun x concurrently \"$(TSGO) -w -p tsconfig.main.json\" \"bun x tsc-alias -w -p tsconfig.main.json\"" \
-		"bun x nodemon --watch dist/main.js --watch dist/main-server.js --delay 500ms --exec 'node dist/main.js server --host $(or $(BACKEND_HOST),localhost) --port $(or $(BACKEND_PORT),3000)'" \
-		"CMUX_VITE_HOST=$(or $(VITE_HOST),127.0.0.1) CMUX_VITE_PORT=$(or $(VITE_PORT),5173) VITE_BACKEND_URL=http://$(or $(BACKEND_HOST),localhost):$(or $(BACKEND_PORT),3000) vite"
+	@npx concurrently -k \
+		"npx concurrently \"$(TSGO) -w -p tsconfig.main.json\" \"bun x tsc-alias -w -p tsconfig.main.json\"" \
+		"bun x nodemon --watch dist/main.js --watch dist/main-server.js --delay 500ms --exec \"node dist/main.js server --host $(or $(BACKEND_HOST),localhost) --port $(or $(BACKEND_PORT),3000)\"" \
+		"$(SHELL) -lc \"CMUX_VITE_HOST=$(or $(VITE_HOST),127.0.0.1) CMUX_VITE_PORT=$(or $(VITE_PORT),5173) VITE_BACKEND_URL=http://$(or $(BACKEND_HOST),localhost):$(or $(BACKEND_PORT),3000) vite\""
 
 
 
@@ -162,16 +172,16 @@ MAGICK_CMD := $(shell command -v magick 2>/dev/null || command -v convert 2>/dev
 build/icon.png: docs/img/logo.webp
 	@echo "Generating Linux icon..."
 	@mkdir -p build
-	@$(MAGICK_CMD) docs/img/logo.webp -resize 512x512 build/icon.png
+	@"$(MAGICK_CMD)" docs/img/logo.webp -resize 512x512 build/icon.png
 
 build/icon.icns: docs/img/logo.webp
 	@echo "Generating macOS icon..."
 	@mkdir -p build/icon.iconset
 	@for size in 16 32 64 128 256 512; do \
-		$(MAGICK_CMD) docs/img/logo.webp -resize $${size}x$${size} build/icon.iconset/icon_$${size}x$${size}.png; \
+		"$(MAGICK_CMD)" docs/img/logo.webp -resize $${size}x$${size} build/icon.iconset/icon_$${size}x$${size}.png; \
 		if [ $$size -le 256 ]; then \
 			double=$$((size * 2)); \
-			$(MAGICK_CMD) docs/img/logo.webp -resize $${double}x$${double} build/icon.iconset/icon_$${size}x$${size}@2x.png; \
+			"$(MAGICK_CMD)" docs/img/logo.webp -resize $${double}x$${double} build/icon.iconset/icon_$${size}x$${size}@2x.png; \
 		fi; \
 	done
 	@iconutil -c icns build/icon.iconset -o build/icon.icns

bun.lock

@@ -1,5 +1,6 @@
 {
   "lockfileVersion": 1,
+  "configVersion": 0,
   "workspaces": {
     "": {
       "name": "mux",
@@ -72,7 +73,7 @@
         "class-variance-authority": "^0.7.1",
         "clsx": "^2.1.1",
         "cmdk": "^1.0.0",
-        "concurrently": "^8.2.0",
+        "concurrently": "^9.2.1",
         "dotenv": "^17.2.3",
         "electron": "^38.2.1",
         "electron-builder": "^24.6.0",
@@ -1202,7 +1203,7 @@
 
     "concat-map": ["concat-map@0.0.1", "", {}, "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg=="],
 
-    "concurrently": ["concurrently@8.2.2", "", { "dependencies": { "chalk": "^4.1.2", "date-fns": "^2.30.0", "lodash": "^4.17.21", "rxjs": "^7.8.1", "shell-quote": "^1.8.1", "spawn-command": "0.0.2", "supports-color": "^8.1.1", "tree-kill": "^1.2.2", "yargs": "^17.7.2" }, "bin": { "conc": "dist/bin/concurrently.js", "concurrently": "dist/bin/concurrently.js" } }, "sha512-1dP4gpXFhei8IOtlXRE/T/4H88ElHgTiUzh71YUmtjTEHMSRS2Z/fgOxHSxxusGHogsRfxNq1vyAwxSC+EVyDg=="],
+    "concurrently": ["concurrently@9.2.1", "", { "dependencies": { "chalk": "4.1.2", "rxjs": "7.8.2", "shell-quote": "1.8.3", "supports-color": "8.1.1", "tree-kill": "1.2.2", "yargs": "17.7.2" }, "bin": { "conc": "dist/bin/concurrently.js", "concurrently": "dist/bin/concurrently.js" } }, "sha512-fsfrO0MxV64Znoy8/l1vVIjjHa29SZyyqPgQBwhiDcaW8wJc2W3XWVOGx4M3oJBnv/zdUZIIp1gDeS98GzP8Ng=="],
 
     "confbox": ["confbox@0.2.2", "", {}, "sha512-1NB+BKqhtNipMsov4xI/NnhCKp9XG9NamYp5PVm9klAT0fsrNPjaFICsCFhNhwZJKNh7zB/3q8qXz0E9oaMNtQ=="],
 
@@ -1320,8 +1321,6 @@
 
     "data-view-byte-offset": ["data-view-byte-offset@1.0.1", "", { "dependencies": { "call-bound": "^1.0.2", "es-errors": "^1.3.0", "is-data-view": "^1.0.1" } }, "sha512-BS8PfmtDGnrgYdOonGZQdLZslWIeCGFP9tpan0hi1Co2Zr2NKADsvGYA8XxuG/4UWgJ6Cjtv+YJnB6MM69QGlQ=="],
 
-    "date-fns": ["date-fns@2.30.0", "", { "dependencies": { "@babel/runtime": "^7.21.0" } }, "sha512-fnULvOpxnC5/Vg3NCiWelDsLiUc9bRwAPs/+LfTLNvetFCtCTN+yQz15C/fs4AwX1R9K5GLtLfn8QW+dWisaAw=="],
-
     "dayjs": ["dayjs@1.11.18", "", {}, "sha512-zFBQ7WFRvVRhKcWoUh+ZA1g2HVgUbsZm9sbddh8EC5iv93sui8DVVz1Npvz+r6meo9VKfa8NyLWBsQK1VvIKPA=="],
 
     "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="],
@@ -2578,8 +2577,6 @@
 
     "space-separated-tokens": ["space-separated-tokens@2.0.2", "", {}, "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q=="],
 
-    "spawn-command": ["spawn-command@0.0.2", "", {}, "sha512-zC8zGoGkmc8J9ndvml8Xksr1Amk9qBujgbF0JAIWO7kXr43w0h/0GJNM/Vustixu+YE8N/MTrQ7N31FvHUACxQ=="],
-
     "spawn-wrap": ["spawn-wrap@2.0.0", "", { "dependencies": { "foreground-child": "^2.0.0", "is-windows": "^1.0.2", "make-dir": "^3.0.0", "rimraf": "^3.0.0", "signal-exit": "^3.0.2", "which": "^2.0.1" } }, "sha512-EeajNjfN9zMnULLwhZZQU3GWBoFNkbngTUPfaawT4RkMiviTxcX0qfhVbGey39mfctfDHkWtuecgQ8NJcyQWHg=="],
 
     "spawnd": ["spawnd@5.0.0", "", { "dependencies": { "exit": "^0.1.2", "signal-exit": "^3.0.3", "tree-kill": "^1.2.2", "wait-port": "^0.2.9" } }, "sha512-28+AJr82moMVWolQvlAIv3JcYDkjkFTEmfDc503wxrF5l2rQ3dFz6DpbXp3kD4zmgGGldfM4xM4v1sFj/ZaIOA=="],

eslint.config.mjs

@@ -407,6 +407,7 @@ export default defineConfig([
       "src/services/**",
       "src/runtime/**",
       "src/utils/main/**",
+      "src/utils/platform/**",
       "src/utils/providers/**",
       "src/telemetry/**",
       "src/git.ts",

fmt.mk

@@ -34,36 +34,35 @@ fmt-prettier-check:
 
 fmt-shell:
 ifeq ($(SHFMT),)
-	@echo "Error: shfmt not found. Install with: brew install shfmt"
-	@exit 1
+	@echo "shfmt not found; skipping shell script formatting"
 else
 	@echo "Formatting shell scripts..."
 	@shfmt -i 2 -ci -bn -w $(SHELL_SCRIPTS)
 endif
 
 fmt-shell-check:
 ifeq ($(SHFMT),)
-	@echo "Error: shfmt not found. Install with: brew install shfmt"
-	@exit 1
+	@echo "shfmt not found; skipping shell script format check"
 else
 	@echo "Checking shell script formatting..."
 	@shfmt -i 2 -ci -bn -d $(SHELL_SCRIPTS)
 endif
 
-# Helper target to check for uvx
-.check-uvx:
+fmt-python:
 ifeq ($(UVX),)
-	@echo "Error: uvx not found. Install with: curl -LsSf https://astral.sh/uv/install.sh | sh"
-	@exit 1
-endif
-
-fmt-python: .check-uvx
+	@echo "uvx not found; skipping Python formatting"
+else
 	@echo "Formatting Python files..."
 	@$(UVX) ruff format $(PYTHON_DIRS)
+endif
 
-fmt-python-check: .check-uvx
+fmt-python-check:
+ifeq ($(UVX),)
+	@echo "uvx not found; skipping Python format check"
+else
 	@echo "Checking Python formatting..."
 	@$(UVX) ruff format --check $(PYTHON_DIRS)
+endif
 
 fmt-nix:
 ifeq ($(NIX),)

package.json

@@ -113,7 +113,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.0.0",
-    "concurrently": "^8.2.0",
+    "concurrently": "^9.2.1",
     "dotenv": "^17.2.3",
     "electron": "^38.2.1",
     "electron-builder": "^24.6.0",
@@ -204,7 +204,9 @@
       "artifactName": "${productName}-${version}-${arch}.${ext}"
     },
     "win": {
-      "target": "nsis"
+      "target": "nsis",
+      "icon": "build/icon.png",
+      "artifactName": "${productName}-${version}-${arch}.${ext}"
     }
   }
 }

src/App.tsx

@@ -177,7 +177,7 @@ function AppInner() {
   );
 
   const handleAddWorkspace = useCallback(async (projectPath: string) => {
-    const projectName = projectPath.split("/").pop() ?? projectPath.split("\\").pop() ?? "project";
+    const projectName = projectPath.replace(/\\/g, "/").split("/").pop() ?? "project";
 
     workspaceModalProjectRef.current = projectPath;
     setWorkspaceModalProject(projectPath);
@@ -637,15 +637,22 @@ function AppInner() {
           <div className="mobile-layout flex flex-1 overflow-hidden">
             {selectedWorkspace ? (
               <ErrorBoundary
-                workspaceInfo={`${selectedWorkspace.projectName}/${selectedWorkspace.namedWorkspacePath?.split("/").pop() ?? selectedWorkspace.workspaceId}`}
+                workspaceInfo={`${selectedWorkspace.projectName}/${
+                  (selectedWorkspace.namedWorkspacePath ?? "")
+                    .replace(/\\/g, "/")
+                    .split("/")
+                    .pop() ?? selectedWorkspace.workspaceId
+                }`}
               >
                 <AIView
                   key={selectedWorkspace.workspaceId}
                   workspaceId={selectedWorkspace.workspaceId}
                   projectName={selectedWorkspace.projectName}
                   branch={
-                    selectedWorkspace.namedWorkspacePath?.split("/").pop() ??
-                    selectedWorkspace.workspaceId
+                    (selectedWorkspace.namedWorkspacePath ?? "")
+                      .replace(/\\/g, "/")
+                      .split("/")
+                      .pop() ?? selectedWorkspace.workspaceId
                   }
                   namedWorkspacePath={selectedWorkspace.namedWorkspacePath ?? ""}
                   runtimeConfig={

src/components/NewWorkspaceModal.tsx

@@ -4,6 +4,7 @@ import { TooltipWrapper, Tooltip } from "./Tooltip";
 import { formatNewCommand } from "@/utils/chatCommands";
 import { useNewWorkspaceOptions } from "@/hooks/useNewWorkspaceOptions";
 import { RUNTIME_MODE } from "@/types/runtime";
+import { formatWorkspaceLocation, formatSSHHostPath } from "@/utils/ui/pathFormatting";
 
 interface NewWorkspaceModalProps {
   isOpen: boolean;
@@ -247,8 +248,8 @@ const NewWorkspaceModal: React.FC<NewWorkspaceModalProps> = ({
           <p>This will create a workspace at:</p>
           <code className="block break-all">
             {runtimeMode === RUNTIME_MODE.SSH
-              ? `${sshHost || "<host>"}:~/cmux/${branchName || "<branch-name>"}`
-              : `~/.cmux/src/${projectName}/${branchName || "<branch-name>"}`}
+              ? formatSSHHostPath(sshHost || "<host>", `cmux/${branchName || "<branch-name>"}`)
+              : formatWorkspaceLocation(projectName, branchName || "<branch-name>", false)}
           </code>
         </ModalInfo>
 

src/components/ProjectSidebar.tsx

@@ -10,6 +10,7 @@ import { useDrag, useDrop, useDragLayer } from "react-dnd";
 import { sortProjectsByOrder, reorderProjects, normalizeOrder } from "@/utils/projectOrdering";
 import { matchesKeybind, formatKeybind, KEYBINDS } from "@/utils/ui/keybinds";
 import { abbreviatePath, splitAbbreviatedPath } from "@/utils/ui/pathAbbreviation";
+import { PlatformPaths } from "@/utils/platform/paths";
 import {
   partitionWorkspacesByAge,
   formatOldWorkspaceThreshold,
@@ -234,12 +235,7 @@ const ProjectSidebarInner: React.FC<ProjectSidebarProps> = ({
     anchor: { top: number; left: number } | null;
   } | null>(null);
 
-  const getProjectName = (path: string) => {
-    if (!path || typeof path !== "string") {
-      return "Unknown";
-    }
-    return path.split("/").pop() ?? path.split("\\").pop() ?? path;
-  };
+  const getProjectName = (path: string) => PlatformPaths.getProjectName(path);
 
   const toggleProject = (projectPath: string) => {
     const newExpanded = new Set(expandedProjects);