Installation & Updates

Homebrew on macOS

brew install --cask duxweb/tap/codux

Upgrade later:

brew upgrade --cask codux

Requires macOS 14 (Sonoma) or later. The cask installs the Developer ID signed, notarized build.

Direct download

Grab the package for your platform from GitHub Releases:

• macOS, Apple Silicon — codux-macos-aarch64.dmg
• macOS, Intel — codux-macos-x86_64.dmg
• Windows — codux-windows-x86_64-setup.exe

Windows first launch

The Windows installer isn’t code-signed yet, so SmartScreen may show “Windows protected your PC”. Click More info → Run anyway. It’s a per-user install (to %LOCALAPPDATA%\Programs\Codux), so no administrator rights are needed.

macOS first launch

The official macOS build is signed and notarized, so it just opens. This fallback only applies if you run an unsigned or development build and see “Cannot be opened because the developer cannot be verified.”

sudo xattr -rd com.apple.quarantine /Applications/Codux.app

Or open System Settings → Privacy & Security, scroll down, and click Open Anyway next to the Codux warning.

Updates

Codux has a built-in updater with stable and beta channels, so it can update itself in place. On macOS you can also brew upgrade --cask codux, or just re-download the latest package.

System requirements

• macOS 14 (Sonoma)+ or Windows (x86_64)
• One or more AI CLIs installed separately — Claude Code, Codex, OpenCode, Kiro, CodeWhale, Kimi Code, MiMo-Code, or Agy