Installation

Codemux ships pre-built for Linux (AppImage / .deb / .rpm / AUR) and Windows (NSIS .exe). The same binaries auto-update through the in-app updater. For source builds, see Build from Source below.

Windows users should also read the dedicated Windows Setup page for agent-CLI installation and known limitations.

Linux

AppImage (recommended — works on every distro)

curl -L https://github.com/Zeus-Deus/codemux/releases/latest/download/codemux_0.2.5_amd64.AppImage -o codemux.AppImage
chmod +x codemux.AppImage
./codemux.AppImage

The AppImage is self-contained and bundles every runtime dependency. Drop it anywhere on your PATH (or use AppImageLauncher to integrate it with your menu and file associations).

In-app auto-update is wired through the same latest.json regardless of which package format you used.

Debian / Ubuntu

curl -L https://github.com/Zeus-Deus/codemux/releases/latest/download/codemux_0.2.5_amd64.deb -o codemux.deb
sudo dpkg -i codemux.deb
sudo apt-get install -f   # install missing deps if any

Fedora / RHEL

curl -L https://github.com/Zeus-Deus/codemux/releases/latest/download/codemux-0.2.5-1.x86_64.rpm -o codemux.rpm
sudo rpm -i codemux.rpm

Arch (AUR)

yay -S codemux-bin
# or
paru -S codemux-bin

codemux-bin ships the prebuilt binary. If you prefer a from-source AUR package, watch for a codemux package; the canonical source build is documented below.

Always-current download links

Skip the version pin by hitting releases/latest directly:

• https://github.com/Zeus-Deus/codemux/releases/latest

GitHub redirects to the newest published release.

Windows

The NSIS installer is codemux_<version>_x64-setup.exe:

$url = "https://github.com/Zeus-Deus/codemux/releases/latest/download/codemux_0.2.5_x64-setup.exe"
Invoke-WebRequest -Uri $url -OutFile codemux-setup.exe
.\codemux-setup.exe

After installation, see Windows Setup for the agent CLIs (Claude Code, Codex, Gemini, OpenCode, Pi) — those install separately on Windows the same way they do on Linux.

SmartScreen note: the installer is not Authenticode-signed yet. On first install, Windows SmartScreen warns "Windows protected your PC." Click More info → Run anyway.

Updates

Codemux self-updates through the in-app updater on Linux (AppImage) and Windows (NSIS). When a new release is available, you'll see a toast notification and an Update button in the title bar. The updater downloads the new binary, verifies its signature, and prompts you to restart.

Package-manager installs (.deb, .rpm, AUR) get updates through their respective package managers — re-run apt, dnf, or yay -Syu to refresh.

Build from Source

If you want to hack on Codemux itself, or if the prebuilt binaries don't fit your distro, building from source is straightforward.

Requirements

• OS: Linux (X11 or Wayland), Windows 10 1809+, or Windows 11
• Rust: 1.75+ (install via rustup)
• Node.js: 20+ with npm
• Bun: 1.3+ (for the bundled Claude sidecar — install via curl -fsSL https://bun.sh/install | bash)
• System libraries: Tauri 2 dependencies for your distro

Linux system deps

Arch:

sudo pacman -S webkit2gtk-4.1 base-devel curl wget file openssl appmenu-gtk-module gtk3 libappindicator-gtk3 librsvg

Ubuntu / Debian:

sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file libssl-dev libayatana-appindicator3-dev librsvg2-dev

Fedora:

sudo dnf install webkit2gtk4.1-devel gcc-c++ openssl-devel curl wget file librsvg2-devel libappindicator-gtk3-devel

Build

git clone https://github.com/Zeus-Deus/codemux.git
cd codemux
npm install
npm run build

For development mode with hot reload:

npm run dev

This starts the Vite dev server and the Tauri application together. Dev builds use a separate data directory so they don't collide with an installed release on the same machine.

Verification

npm run verify

Runs cargo check, cargo test, tsc --noEmit, and vitest.

Optional Tools

These are not required but enable additional features:

• gh (GitHub CLI) — Enables PR creation, CI checks, review comments. Required for Pull Requests.
• claude (Claude Code CLI) — AI commit messages, merge conflict resolution, Claude-provider chat sessions.
• codex — OpenAI Codex CLI for Codex-provider chat sessions.
• opencode — OpenCode CLI for the federated multi-provider chat option (100+ upstream providers behind one rail entry).
• fd — Fast file search (Ctrl+Shift+P).
• ripgrep — Fast code search (Ctrl+Shift+F).
• ydotool — OS-level browser input for stealth automation (Tier 3). Requires ydotoold daemon running. Only needed for bypassing anti-bot detection.
• docker / docker compose — Container management for setup/teardown scripts.
• xdg-desktop-portal (+ a backend such as xdg-desktop-portal-gtk) or zenity — Native file pickers ("Open Project", attach file, settings import/export). Most desktop environments ship a portal already; bare window managers (i3, dwm, …) often don't, and without either backend file dialogs silently fail to open. Run codemux doctor to check. The AUR package already pulls the portal in as a dependency.

First Launch

1. Codemux opens with a login screen — sign in with GitHub or email, or click "Skip" to use it without an account (settings won't sync).
2. The empty-state Home shows quick actions: Open Project / New Project.
3. Open a project and create a workspace via the sidebar + button.
4. Press Ctrl+T for a terminal or Ctrl+Shift+D to split a pane; open a browser from the tab bar's + dropdown.

To try Agent Chat (Beta), go to Settings (Ctrl+,) → Beta Features → enable.