Documentation Install HiRoute Desktop on Omarchy

Install and open HiRoute on Omarchy

HiRoute provides a signed Arch package for Omarchy on x86_64 and ARM64. It includes the desktop app, launcher and matching CLI/service payload. The app and CLI share the current user's models, routes, Agents and sessions.

1. Choose your architecture

Run uname -m in a terminal. Choose x86_64 for x86_64, or ARM64 for aarch64, on the Omarchy installation page.

Save the package, its .sig and its .sha256 file in the same folder. The installation page gives commands for the exact selected package. Keep its original filename, including .pkg.tar.xz or .pkg.tar.zst.

2. Verify the package and release key

In the download folder, set package to the exact downloaded package filename, then check its checksum.

package='PASTE_EXACT_PACKAGE_FILENAME'
sha256sum --check "$package.sha256"

Download the HiRoute release public key as omarchy-release-key.asc and inspect it.

gpg --show-keys --with-fingerprint omarchy-release-key.asc

The primary fingerprint must match CB5F8ADEDC272ED8879D206C5642FA57EA8DF169. Stop if the fingerprint or checksum differs, and recheck the source and files.

3. Install the signed package

After checking the fingerprint, add the release key to pacman's keyring and locally trust that key. Install the package with its adjacent signature.

sudo pacman-key --add omarchy-release-key.asc &&
sudo pacman-key --lsign-key CB5F8ADEDC272ED8879D206C5642FA57EA8DF169 &&
sudo pacman-key --verify "$package.sig" "$package" &&
sudo pacman -U "$package"

Installation starts only after signature verification succeeds. If the .sig file is missing or verification fails, recheck the source and files.

4. Open HiRoute from Apps

Open HiRoute from the Omarchy app launcher. On first launch, choose Install background service to set up the current user's CLI, service and local console. You can also choose to start the service at login. An existing compatible installation retains its listener and service settings.

When the console opens, connect your first model, then follow the Quickstart. Closing the desktop window leaves the background service running.

Update HiRoute

Download and verify the newer package, then install it with pacman -U. When the startup screen offers Check for service update…, review the versions and restart impact, then choose Update and restart. This preserves your existing configuration and data.

Open in browser lets you keep using an existing service while arranging its update. If the local console is disabled, follow the terminal steps on the startup screen.

Remove the service or application

To remove the user runtime, open Settings → Desktop app → Remove service… and review the affected Agents. Resolve any Agent settings that need attention before retrying. Saved models, Plans and history remain available for reinstallation.

The system package and launcher are removed separately with sudo pacman -R hiroute-desktop. Removing the package alone leaves the current user's runtime and data in place.