macOS

Download & install

A signed macOS build isn't available, but you can build it from source.

Run the script

The custom script will automatically install CLauncher on your system. You can check the interactive tab to see what it does.

curl -fsSL https://cdn.cirax.dev/clauncher/mac-install.sh | bash

Install Node.js

Install Node.js 18 or later from nodejs.org, or use Homebrew:

# with Homebrew

brew install node

Clone the repository

Clone from GitHub and enter the project directory.

git clone https://github.com/Cirax856/clauncher

cd clauncher

Install dependencies

Install all required packages. The --ingore-scripts flag skips the Electron binary download during install, it gets fetched during build instead.

npm install --ignore-scripts

Build the app

This compiles the React frontend and packages everything into a .dmg installer in the release/ folder.

CSC_IDENTITY_AUTO_DISCOVERY=false npm run dist -- --mac

The build is unsigned. macOS might show a warning the first time it's opened. Right-click the app and choose Open to bypass it.

Install and run

Open the release/ folder, double-click the .dmg file and drag CLauncher to your Applications folder.

open release/