Codemux v0.2.7

What's New

Features

• MCP server — new Model Context Protocol server with Phase 1 vexis-agent integration tools, Phase 1.5 delegation primitives, and Phase 1.6 lifecycle + issue tools, so external agents can drive Codemux workspaces, ports, and issues
• Agent status tracking for Codex, Gemini, OpenCode, and Pi hooks — the needs-input / working / done pulse now lights up for these agents, not just Claude Code

Fixes

• virtual-display: reserve owned display numbers across acquires so concurrent workspaces don't collide on a display
• worktree: compare worktree paths as Path rather than str (fixes Windows path matching) and detect-and-reuse an existing worktree in git_create_worktree
• workspace: keep the UI responsive while deleting large worktrees
• commands: move blocking I/O off the GTK main thread
• editor: render raw HTML in the markdown preview
• mcp: expand app_status, clarify the port_list filter, and cover edge cases

Other

• hooks test: make the Codex bare-command assertion platform-aware
• sandbox test: update the close_workspace canary for async signatures
• docs: add an MCP Server section to the README

Install

AppImage (any Linux distro)

chmod +x codemux_0.2.7_amd64.AppImage
./codemux_0.2.7_amd64.AppImage

Arch Linux (AUR)

yay -S codemux-bin

Debian/Ubuntu

sudo dpkg -i codemux_0.2.7_amd64.deb

Windows

Download Codemux_0.2.7_x64-setup.exe from the release assets and run the installer.

Note: The installer is not code-signed yet. Windows SmartScreen may show a warning — click "More info" → "Run anyway" to proceed. This will be resolved in a future release.

Existing users: Both Linux (AppImage) and Windows users will be prompted to update automatically via the Tauri auto-updater. No manual download required — the updater handles it on next app launch.

Codemux v0.2.6

What's New

Features

• Browser viewport presets — toggle between mobile, tablet, and desktop sizes (plus arbitrary WxH) right in the browser pane, so CSS media queries actually fire at the target width while you iterate on responsive UI.
• Paste clipboard images directly into the new-workspace prompt — Ctrl+V an image and it's attached to the prompt without saving to disk first.

Fixes

• Publish-branch prompt no longer mis-fires — a branch is now treated as published when its remote-tracking ref exists, so the "publish this branch?" prompt stops appearing for already-pushed branches.

Other

• Docs refresh: refreshed STATUS.md, PLAN.md, feature docs, and archived stale plans.

Install

AppImage (any Linux distro)

chmod +x codemux_0.2.6_amd64.AppImage
./codemux_0.2.6_amd64.AppImage

Arch Linux (AUR)

yay -S codemux-bin

Debian/Ubuntu

sudo dpkg -i codemux_0.2.6_amd64.deb

Windows

Download codemux_0.2.6_x64-setup.exe from the release assets and run the installer.

Note: The installer is not code-signed yet. Windows SmartScreen may show a warning — click "More info" → "Run anyway" to proceed. This will be resolved in a future release.

Existing users: Both Linux (AppImage) and Windows users will be prompted to update automatically via the Tauri auto-updater. No manual download required — the updater handles it on next app launch.

Codemux v0.2.5

What's New

Fixes

• Hard UI freeze when a git/gh subprocess stalled — Codemux's GitHub-repo detection ran git remote -v synchronously on the GTK main thread. A wedged git (slow disk, stuck FS, credential prompt) blocked the UI event loop so completely that even the window-close request could not be processed. The same hazard existed for every other sync Tauri command that shelled out to git or gh. All of them — full git operations (status, diff, commit, push, pull, fetch, stash, log, branches, worktrees, merge/conflict handling) and full GitHub operations (PRs, issues, checks, deployments, reviews) — now run on Tokio's blocking pool, so a stalled subprocess can no longer freeze the UI.

Other

• Bumped version to 0.2.5.

Install

AppImage (any Linux distro)

chmod +x codemux_0.2.5_amd64.AppImage
./codemux_0.2.5_amd64.AppImage

Arch Linux (AUR)

yay -S codemux-bin

Debian/Ubuntu

sudo dpkg -i codemux_0.2.5_amd64.deb

Windows

Download Codemux_0.2.5_x64-setup.exe from the release assets and run the installer.

Note: The installer is not code-signed yet. Windows SmartScreen may show a warning — click "More info" → "Run anyway" to proceed. This will be resolved in a future release.

Existing users: Both Linux (AppImage) and Windows users will be prompted to update automatically via the Tauri auto-updater. No manual download required — the updater handles it on next app launch.

Codemux v0.2.4

What's New

This is a performance-focused release. No new features or behavior changes — Codemux should just feel snappier across the board, especially during workspace switching, editor file loading, and high-frequency backend updates.

Performance

• State coalescing: High-frequency app-state emits from the backend are now coalesced into 16ms windows, dropping re-render storms during active orchestration
• Markdown & workspace-tied components: Stopped re-rendering the markdown view and workspace-bound components on every backend tick
• CSS transitions: Scoped transition-all to only the properties that actually animate, eliminating per-frame style recomputation on hover/focus
• Workspace switch: Cut mount-time IPC roundtrips and unblocked the IPC thread, making workspace switches feel instant
• Editor file loading: File read and language module import now run in parallel, reducing time-to-first-paint when opening a file
• Worktree-include listener: No longer re-attached on every backend tick — single mount, single listener
• Draft-when-empty hook: Effect now fingerprints on primitives instead of re-running on every reference change

Install

AppImage (any Linux distro)

chmod +x codemux_0.2.4_amd64.AppImage
./codemux_0.2.4_amd64.AppImage

Arch Linux (AUR)

yay -S codemux-bin

Debian/Ubuntu

sudo dpkg -i codemux_0.2.4_amd64.deb

Windows

Download Codemux_0.2.4_x64-setup.exe from the release assets and run the installer.

Note: The installer is not code-signed yet. Windows SmartScreen may show a warning — click "More info" → "Run anyway" to proceed. This will be resolved in a future release.

Existing users: Both Linux (AppImage) and Windows users will be prompted to update automatically via the Tauri auto-updater. No manual download required — the updater handles it on next app launch.

Codemux v0.2.3

What's New

Fixes

• editor: load images in markdown and as standalone files
• sidebar: refresh ahead/behind arrows against fresh remote refs
• github: hide stale merged-PR pill on long-lived branches
• merge: run merge-into-base on blocking pool to prevent app freeze
• review: unfreeze Review tab on repos with thousands of PRs

Other

• chore: sync package-lock.json with 0.2.2 version bump

Install

AppImage (any Linux distro)

chmod +x codemux_0.2.3_amd64.AppImage
./codemux_0.2.3_amd64.AppImage

Arch Linux (AUR)

yay -S codemux-bin

Debian/Ubuntu

sudo dpkg -i codemux_0.2.3_amd64.deb

Windows

Download codemux_0.2.3_x64-setup.exe from the release assets and run the installer.

Note: The installer is not code-signed yet. Windows SmartScreen may show a warning — click "More info" → "Run anyway" to proceed. This will be resolved in a future release.

Existing users: Both Linux (AppImage) and Windows users will be prompted to update automatically via the Tauri auto-updater. No manual download required — the updater handles it on next app launch.

Codemux v0.2.2

What's New

Features

• Labeled merge CTA + shared model picker for the merge resolver and settings panes
• Isolate dev builds from installed release so codemux dev no longer collides with a stable install

Fixes

• Browser: unify port keying and harden daemon lifecycle (resolves stuck/broken browser streams)
• Codex: retry probe spawns on ETXTBSY (text file busy)
• Notifications: drop desktop popups from Critical to Normal urgency so they no longer steal focus
• Terminal: cap pending_output by bytes (256 MiB) instead of chunks, and throttle reattach replay so multi-MB buffers can't freeze the renderer
• Agent chat: stop leaking agent-chat sidecars on workspace/tab/pane close
• Agent chat: sync mirror scroll with composer textarea
• Scripts: prevent worktree includes from truncating .env at project root
• Tests: use APP_DIR_NAME in display_secrets_dir test so debug builds pass

Performance

• Memoize transcript rows and file-tree nodes to skip per-token re-renders during chat streaming

Other

• Drop dead workspace_id alias lookups in browser
• Bump checkout/setup-node to v5 to clear Node 20 deprecation warning
• Sync package-lock.json
• Align AGENTS.md with CLAUDE.md session bootstrap

Install

AppImage (any Linux distro)

chmod +x codemux_0.2.2_amd64.AppImage
./codemux_0.2.2_amd64.AppImage

Arch Linux (AUR)

yay -S codemux-bin

Debian/Ubuntu

sudo dpkg -i codemux_0.2.2_amd64.deb

Windows

Download Codemux_0.2.2_x64-setup.exe from the release assets and run the installer.

Note: The installer is not code-signed yet. Windows SmartScreen may show a warning — click "More info" → "Run anyway" to proceed. This will be resolved in a future release.

Existing users: Both Linux (AppImage) and Windows users will be prompted to update automatically via the Tauri auto-updater. No manual download required — the updater handles it on next app launch.

Codemux v0.2.1

What's New

Fixes

• AUR codemux-bin: agent-chat with Claude now works. The v0.2.0 PKGBUILD did not copy the new claude-agent sidecar resource into the install tree, so AUR users hit Send failed: provider_not_configured: Claude the moment they tried to send a Claude message in agent-chat. Fixed in AUR 0.2.0-2 (already shipped). The skill template that generates the PKGBUILD also got the fix, so it cannot regress on future releases. The same pass also restores the bundled agent-browser binary, which had been silently dropped from AUR installs since the externalBin layout settled (the install heredoc was looking for a triple-suffixed name that Tauri's bundler had already stripped).
• Docs: refresh sidecar references after the v0.2.0 externalBin → resources move (commit 025fa19). Adds a "Packagers note" so downstream repackagers know to pick up the sidecar from the resource layout rather than just usr/bin/codemux.

Notes

• No change for AppImage / deb / rpm / Windows users. The v0.2.0 binaries on those channels already bundle the sidecar correctly — the auto-updater will move you to 0.2.1 but no end-user behavior changes.
• AUR users on 0.2.0-1: if you haven't yet, run yay -Syu codemux-bin to pull the packaging fix (or upgrade to 0.2.1 here).

Install

AppImage (any Linux distro)

chmod +x codemux_0.2.1_amd64.AppImage
./codemux_0.2.1_amd64.AppImage

Arch Linux (AUR)

yay -S codemux-bin

Debian/Ubuntu

sudo dpkg -i codemux_0.2.1_amd64.deb

Windows

Download codemux_0.2.1_x64-setup.exe from the release assets and run the installer.

Note: The installer is not code-signed yet. Windows SmartScreen may show a warning — click "More info" → "Run anyway" to proceed. This will be resolved in a future release.

Existing users: Both Linux (AppImage) and Windows users will be prompted to update automatically via the Tauri auto-updater. No manual download required — the updater handles it on next app launch.

Codemux v0.2.0

What's New

This is a major release introducing the Agent Chat pane — a first-class, in-app conversation surface with Claude, Codex, and OpenCode providers, image and file attachments, skills, slash commands, plan proposals, AskUserQuestion panels, mode pills, and more. It also includes broad Windows portability fixes, end-to-end encrypted skills sync, GitHub issues + PRs attachments, desktop notifications, and a refreshed UI chrome.

Features

Agent Chat (new pane)

• Real chat pane UI with streaming, approvals, and permission-mode restart
• Home landing + capability-driven composer pickers
• Draft surface, Zone 1 pickers, and empty-workspace dispatch
• Plan proposals, AskUserQuestion panel, mode pill, thinking indicator
• Session history selector + draft surface chrome polish
• Persist + replay transcripts on session resume
• Pane-scoped chats, new-tab preset launch, base-branch picker
• Slash command popup + Shift+Tab mode cycling
• Permissions settings page + per-tool body rendering
• "Allow always" dropdown with SDK rule persistence
• Wire Ask, Debug, and Beta Features mode pills
• Unified + popup with modes, folders, send-paired button
• Master Beta Features toggle (Step 13)

Providers

• ClaudeAgentProvider (sidecar-based, SDK integration, auth, lifecycle, events)
• Codex AgentProvider backed by codex app-server with wire-protocol parity + dynamic capability harvest
• OpenCode as third provider with unified provider+model picker, FREE badge, runtime AgentProvider adapter

Attachments & Skills

• File attachments via @ — inline chips, send-time injection
• Image attachments via paste, drop, and + picker
• GitHub issues + PRs end-to-end attachments
• Cross-provider skill system with watcher, conflicts, disable, refined compat
• End-to-end encrypted skills sync (Step 10)

Windows Support

• Tier-3 OS-level input injection via Win32 SendInput
• Auto-detect installed Chromium browser for agent-browser
• Make Claude Code hooks register and execute on Windows
• Replace portable-pty fork with upstream + hidden parent console
• Drop sh -c dependency in agent_browser, spawn binary directly
• Add Windows discovery branch to resolve_binary
• Retry control-pipe client on ERROR_PIPE_BUSY

UI

• Notifications: pop desktop toast and chime when agent finishes off-screen
• Title-bar search pill widened with project + branch
• DM Sans for chrome, mono for code
• Derivative branch picker — icons, recency, worktree tab
• Favorites tab on top of picker rail + visible scrollbar
• Grey out unavailable provider in picker rail

Fixes

• Plain-quit on Beta toggle instead of auto-restart
• Surface Codex install/auth/harvest states in picker
• Right-align FREE badge in model picker rows
• Restrict FREE badge to OpenCode Zen only
• Show multi-provider picker on draft surface too
• Hide chat_agent presets from CLI launcher
• Drop top border on transient setup banner
• Dismiss composer popups on outside click
• Register McpRegistry + 10 missing MCP commands
• Normalize paths + fix four latent Windows portability issues
• Step 10 — show setup form (not repair) for new OAuth users
• Unbreak agent-browser argv test on runners with Edge
• Unbreak agent-browser daemon lifecycle and argv position
• Surface control-endpoint error instead of swallowing it as null
• Stop click restarts the session so next turn works
• Synchronous ref guard on submit + drop redundant Ready event
• Gate submit optimistically to prevent double-send
• Anchor observability snapshot path to home directory
• Tolerate partial observability.json with serde defaults
• Seed default model when slice mounts under existing thread_id

Other

• CI: ripgrep on Linux + Windows runners; gate platform-specific tests to unix
• Build: default-run set to codemux binary; bun build wired into sidecar release pipeline
• Refactor: JsonRpcChild::shutdown takes &self, idempotent
• Docs: agent-chat architecture, sidecar scaffold, ToS boundary, known follow-ups
• Tests: Tauri command integration, sidecar fixtures, end-to-end Rust↔sidecar

Install

AppImage (any Linux distro)

chmod +x codemux_0.2.0_amd64.AppImage
./codemux_0.2.0_amd64.AppImage

Arch Linux (AUR)

yay -S codemux-bin

Debian/Ubuntu

sudo dpkg -i codemux_0.2.0_amd64.deb

Windows

Download Codemux_0.2.0_x64-setup.exe from the release assets and run the installer.

Note: The installer is not code-signed yet. Windows SmartScreen may show a warning — click "More info" → "Run anyway" to proceed. This will be resolved in a future release.

Existing users: Both Linux (AppImage) and Windows users will be prompted to update automatically via the Tauri auto-updater. No manual download required — the updater handles it on next app launch.

Codemux v0.1.33

What's New

Fixes

• Restore pane-local terminal lifecycle so regular terminals start reliably without input lag or malformed rendering (2baa42f)
• Restore low-latency pane input (acd1566)

Install

AppImage (any Linux distro)

chmod +x codemux_0.1.33_amd64.AppImage
./codemux_0.1.33_amd64.AppImage

Arch Linux (AUR)

yay -S codemux-bin

Debian/Ubuntu

sudo dpkg -i codemux_0.1.33_amd64.deb

Windows

Download Codemux_0.1.33_x64-setup.exe from the release assets and run the installer.

Note: The installer is not code-signed yet. Windows SmartScreen may show a warning — click "More info" → "Run anyway" to proceed. This will be resolved in a future release.

Existing users: Both Linux (AppImage) and Windows users will be prompted to update automatically via the Tauri auto-updater. No manual download required — the updater handles it on next app launch.

Codemux v0.1.32

What's New

Fixes

• fix(terminal): pause hidden terminals to kill cross-workspace typing lag (#13)
  After v0.1.30 introduced terminal persistence across workspace switches, hidden terminals stayed fully active — every PTY byte from any session ran ANSI parse + xterm.write + WebGL render, so each keystroke paid O(N workspaces) cost. Leaked WebGL contexts also blew past the browser's ~16 cap, triggering slow GPU evictions on every workspace switch.

  Now park = "buffer, don't render". Hidden terminals queue PTY bytes in a 16 MB buffer instead of writing them. On reactivate, the buffer drains via a single terminal.write — xterm parses the same byte stream in the same order, so the visible state is identical to live writes (no scramble regression). WebGL addon is disposed on park (frees GPU context) and reloaded on activate. Kitty keyboard state still ticks at receive time so the per-PTY stack stays in sync with the agent.

Other

• chore: bump version to 0.1.32

Install

AppImage (any Linux distro)

chmod +x codemux_0.1.32_amd64.AppImage
./codemux_0.1.32_amd64.AppImage

Arch Linux (AUR)

yay -S codemux-bin

Debian/Ubuntu

sudo dpkg -i codemux_0.1.32_amd64.deb

Windows

Download Codemux_0.1.32_x64-setup.exe from the release assets and run the installer.

Note: The installer is not code-signed yet. Windows SmartScreen may show a warning — click "More info" → "Run anyway" to proceed. This will be resolved in a future release.

Existing users: Both Linux (AppImage) and Windows users will be prompted to update automatically via the Tauri auto-updater. No manual download required — the updater handles it on next app launch.