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+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.

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, Ctrl+Shift+B for a browser, Ctrl+Shift+D to split.

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