Install the Desktop App

Hyprlayer Desktop runs your agents in one native window: a workstream per git worktree, live diffs, and the ship panel. It drives Claude Code and Codex as first-class harnesses.

Every build ships from hyprlayer-releases.

macOS

Apple Silicon only.

brew install --cask brightblock/tap/hyprlayer-desktop

Or download the .dmg from the latest release.

Windows

x64 only. Download the -setup.exe installer from the latest release and run it.

The installer is not yet code-signed, so SmartScreen shows a warning. Choose More info → Run anyway.

Linux

x86_64 only. Pick the package for your distribution — each one pulls the runtime dependencies for you.

Arch Linux

The hyprlayer-desktop-bin AUR package:

yay -S hyprlayer-desktop-bin

Or with paru:

paru -S hyprlayer-desktop-bin

It is a binary package — it unpacks the published .deb, which is itself built on Arch against Arch’s webkit2gtk-4.1, so no Debian runtime is involved.

Debian and Ubuntu

Download Hyprlayer_<version>_amd64.deb from the latest release, then:

sudo apt install ./Hyprlayer_<version>_amd64.deb

Install through apt rather than dpkg -i so the dependencies resolve.

Fedora, RHEL, and openSUSE

Download Hyprlayer-<version>-1.x86_64.rpm from the latest release, then:

sudo dnf install ./Hyprlayer-<version>-1.x86_64.rpm

On openSUSE, use sudo zypper install ./Hyprlayer-<version>-1.x86_64.rpm.

Requirements

Requirement	Notes
webkit2gtk-4.1	The webview the app renders in
gtk3	Linked directly by the binary
git	Spawned for every worktree, branch, and network operation
xdg-utils	Opens links and files in your desktop’s default handlers

Your package manager installs these. The RPM declares them by soname, because Fedora (webkit2gtk4.1) and openSUSE (libwebkit2gtk-4_1-0) disagree on the package names.

The binary is built against a recent glibc, so it installs cleanly on Ubuntu 24.04, Debian 13, Fedora 40, and newer. Older LTS releases are not supported.

Tiling window managers

The app supports tiling window managers. It draws its own title bar rather than relying on server-side decorations, so it tiles without a floating-window rule.

Updating

Platform	How
macOS	In-app self-update, or brew upgrade --cask hyprlayer-desktop
Windows	In-app self-update
Linux	Through your package manager

On Linux the app does not update itself. Every Linux install comes from a distro package that pacman, apt, or dnf owns, so nothing may write over /usr/bin. When a new version ships, the app shows a notification pointing you at your package manager:

yay -S hyprlayer-desktop-bin          # Arch
sudo apt install ./Hyprlayer_<version>_amd64.deb   # Debian / Ubuntu
sudo dnf install ./Hyprlayer-<version>-1.x86_64.rpm  # Fedora / RHEL

Note

If you installed the 0.5.6 or 0.5.7 AppImage, you will stop being offered updates. Install one of the packages above once, and updates resume through your package manager.

Next Steps

The desktop app and the CLI run the same workflow. Install the CLI too if you want the slash commands in your terminal, then configure your AI tool.