Installation

Choose a method for your platform. Homebrew works on macOS and Linux; PowerShell is for Windows. Cargo requires Rust 1.91 or later.

Homebrew

Install:

brew install tylerbutler/tap/repoverlay

Update:

brew update && brew upgrade repoverlay

Uninstall:

brew uninstall repoverlay

Shell script

Install:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/tylerbutler/repoverlay/releases/latest/download/repoverlay-installer.sh | sh

The installer puts the binary in $CARGO_HOME/bin. If CARGO_HOME is not set, it uses $HOME/.cargo/bin.

Update: Run the install command again to replace the binary.

Uninstall:

rm "${CARGO_HOME:-$HOME/.cargo}/bin/repoverlay"

PowerShell

Install:

irm https://github.com/tylerbutler/repoverlay/releases/latest/download/repoverlay-installer.ps1 | iex

The installer puts the binary in $env:CARGO_HOME\bin. If CARGO_HOME is not set, it uses $env:USERPROFILE\.cargo\bin.

Update: Run the install command again to replace the binary.

Uninstall:

$cargoHome = if ($env:CARGO_HOME) { $env:CARGO_HOME } else { Join-Path $env:USERPROFILE ".cargo" }
Remove-Item (Join-Path $cargoHome "bin\repoverlay.exe")

Cargo

Build from source with Cargo, or use cargo-binstall for a prebuilt binary. If you do not have cargo-binstall, install it first:

cargo install cargo-binstall

Install:

# Install a pre-built binary (faster)
cargo binstall repoverlay

# Build from source
cargo install repoverlay

Update:

cargo binstall repoverlay --force
# or
cargo install repoverlay --force

Uninstall:

cargo uninstall repoverlay

Manual

Download the prebuilt binary for your platform from repoverlay releases.

Update: Download and replace the binary on your PATH.

Uninstall: Delete the binary from your PATH.

Confirm installation

repoverlay --version

If the terminal cannot find the command, restart it. Make sure that the installation directory is on your PATH. Cargo installs to $CARGO_HOME/bin, or $HOME/.cargo/bin by default. On Windows the default is $env:USERPROFILE\.cargo\bin.

When the terminal shows the version, apply your first profile.