Install the Mac app

The one-line installer

Your admin gives you a command of this shape, pointing at your Crewdesk server:

curl -fsSL https://<your-crewdesk-server>/install | sh

Run it in Terminal (or ask a coding agent to run it). On a Mac it installs both the app and the CLI; on Linux, and on an Intel Mac, the CLI only. It needs no sudo and asks no questions, and running it again updates what is there.

What it does, in order:

1. Checks that your Crewdesk server answers.
2. Installs uv if it is missing, then the crewdesk CLI.
3. Downloads the app's disk image, checks its SHA-256 against the release's published checksums, and copies Crewdesk.app to /Applications (or ~/Applications when that isn't writable).
4. Verifies the app's code signature and that it was signed by the release's developer team.

Each failure is a single line, crewdesk-install: error: …, saying what to do next.

CLI only

Set CREWDESK_NO_APP=1 before sh to install just the terminal client.

By hand

If you'd rather not pipe a script into your shell, your server also lists its downloads. Open the .dmg and drag Crewdesk to Applications, then install the CLI wheel with uv tool install.

First launch

The app is signed with an Apple Developer ID but not yet notarized. A copy downloaded with a browser opens the first time with right-click → Open → Open. The installer doesn't hit this, because it doesn't mark the file as downloaded from the internet.

Updates

The app checks for a new release when it starts and shows a banner: install and restart, or "Later". Updates are signed, and the app refuses an update its own key didn't sign. The CLI shows a note with the exact install line when a newer version exists, and crewdesk version checks on demand. See Updates and releases.