Installation

Looking for the desktop app? See Install the Desktop App.

Homebrew (macOS and Linux)

brew tap brightblock/tap
brew install hyprlayer

Windows

winget install BrightBlock.Hyprlayer

Or with Scoop:

scoop bucket add brightblock https://github.com/BrightBlock/scoop-bucket
scoop install hyprlayer

Or install manually with the PowerShell script:

iex "& { $(irm https://raw.githubusercontent.com/BrightBlock/hyprlayer-cli/master/install.ps1) }"

Arch Linux

yay -S hyprlayer-bin

Cargo

cargo install --git https://github.com/BrightBlock/hyprlayer-cli.git

Verify Installation

hyprlayer --help

Updating

Hyprlayer checks for a new release once every 24 hours and prints the upgrade command for your installation method:

Method	Upgrade Command
Homebrew	brew upgrade hyprlayer
winget	winget upgrade BrightBlock.Hyprlayer
Scoop	scoop update hyprlayer
AUR	yay -S hyprlayer-bin
Cargo	cargo install --git https://github.com/BrightBlock/hyprlayer-cli --tag v<version> --force
PowerShell script	Re-run the install script

Or run hyprlayer self-update, which upgrades through whichever package manager installed it. hyprlayer self-update --check reports without installing.

Set autoUpdate: true in the configuration file to let the daily check apply updates silently. That applies to PowerShell-script installs only; every other method keeps the notification. To disable the check, set disableUpdateCheck: true.

Telemetry

Hyprlayer ships anonymized usage analytics on by default so we can prioritize features and catch regressions. We record stable event names, durations, outcomes, and a per-installation UUID. We never record your source code, prompts, model output, file paths, or environment variables. See Telemetry for the full data contract.

Opt out whenever you like:

hyprlayer telemetry off

Next Steps

Agent files for Claude Code and Codex install themselves the first time you run hyprlayer; see Agent Files. Next, initialize thoughts in a project.