Skip to main content

​
Downloads

​
Release Builds

Download Shux

Download pre-built binaries from the releases page.
  • macOS: Signed and notarized DMG (separate builds for Intel/Apple Silicon)
  • Linux: AppImage
  • Windows (alpha): Installer exe

​
Development Builds

Download pre-built binaries of main from GitHub Actions:
  • macOS: Signed and notarized DMG
    • build-macos-x64 (Intel Macs)
    • build-macos-arm64 (Apple Silicon)
  • Linux: build-linux AppImage (portable, works on most distros)
  • Windows: build-windows installer exe
To download:
  1. Go to the PR workflow (main branch)
  2. Click on the latest successful run
  3. Scroll down to “Artifacts” section
  4. Download the appropriate artifact for your platform

​
Installation

​
macOS

  1. Download the DMG file for your Mac:
    • Intel Mac: macos-dmg-x64
    • Apple Silicon: macos-dmg-arm64
  2. Open the DMG file
  3. Drag Shux to Applications folder
  4. Open the app normally
The app is code-signed and notarized by Apple, so it will open without security warnings.

​
Linux

  1. Download the AppImage file
  2. Make it executable: chmod +x shux-*.AppImage
  3. Run it: ./shux-*.AppImage

​
Windows

(alpha) Prerequisites:
  • Install Git for Windows (includes Git Bash). WSL is not supported.
  • Restart Shux after installing Git for Windows.
  1. Download the installer exe from releases (e.g., shux-x.x.x-x64.exe)
  2. Run the installer
  3. Follow the installation prompts
  4. Launch Shux from the Start menu or desktop shortcut
Windows support is currently in alpha. Please report any issues you encounter.

​
Testing Pre-Release Builds

Only builds from the main branch are signed and notarized. If you’re testing a build from a pull request or other branch, you’ll need to bypass macOS Gatekeeper:
  1. After installing, open Terminal
  2. Run: xattr -cr /Applications/shux.app
  3. Run: codesign --force --deep --sign - /Applications/shux.app
  4. Now you can open the app normally

​
CLI via npm

The Shux CLI can also be run directly via npx without installing the desktop app:
Or install globally:
The legacy mux package and command forward to the matching Shux release during the transition. See Mux compatibility for storage, environment-variable, and downgrade details. This is ideal for CI/CD pipelines and scripted automation. See the CLI documentation for all available commands and options.