Install tmux or herdr on your Host

Waycar starts and shows agents inside herdr or tmux, so your Host needs one of them. If it has neither, install herdr (one command, no admin rights) or tmux 3.2 or later, then tap Check Again in Waycar.

Install herdr

herdr’s installer is the quickest way. It needs no admin rights and works on Linux and macOS, on x86_64 and aarch64. Run this on the Host:

curl -fsSL https://herdr.dev/install.sh | sh

What it does:

• Downloads the latest herdr release for your system from herdr.dev.
• Checks the download against the SHA-256 checksum in herdr.dev’s release manifest, and stops if it doesn’t match.
• Writes one file, ~/.local/bin/herdr, and creates the folder if it’s missing. It doesn’t edit your shell files and never uses sudo.
• Needs curl, awk, and one of sha256sum, shasum or openssl.

If it prints that ~/.local/bin isn’t in your PATH, add it to your shell profile:

export PATH="$HOME/.local/bin:$PATH"

Waycar already looks in ~/.local/bin when it checks for herdr, so you can skip that step for Waycar alone.

herdr is a separate project. Waycar isn’t affiliated with herdr, and its installer is herdr’s own script. Read it first at herdr.dev/install.sh if you like. For herdr’s own install notes, see herdr.dev.

Install tmux

Waycar needs tmux 3.2 or later. Run the line for your system on the Host, then check the version with tmux -V.

System	Command
Ubuntu, Debian	sudo apt install tmux
Fedora, RHEL 9 or later, Alma 9 or later, Rocky 9 or later	sudo dnf install tmux
Arch Linux	sudo pacman -S tmux
openSUSE	sudo zypper install tmux
Alpine Linux	sudo apk add tmux
macOS with Homebrew	brew install tmux

Old tmux versions

Some releases ship a tmux older than 3.2. Waycar can’t use these, so install herdr instead:

System	tmux it ships	What to do
RHEL, Alma Linux, Rocky Linux 8	2.7	Install herdr
Ubuntu 20.04	3.0a	Install herdr, or upgrade Ubuntu
Debian 11	3.1c	Install herdr, or upgrade Debian
Ubuntu 22.04 or later	3.2a or later	Works
Debian 12 or later	3.3a or later	Works

When the install from Waycar fails

Waycar can run these installs for you over SSH after you confirm. If one fails, it names the reason. Find it below, fix it, and tap Check Again. You can also run the command yourself on the Host with Copy command.

Needs admin rights

tmux comes from your system’s package manager, which usually needs sudo. Waycar runs sudo only when it doesn’t ask for a password, and it never asks for one. If your account has no passwordless sudo:

• Run the tmux command from the table above yourself, in a terminal on the Host, and type your password there.
• Or install herdr. It needs no admin rights.

Can’t reach herdr.dev

The Host couldn’t download herdr’s installer or its release manifest. Check that the Host has internet access and can open https://herdr.dev. A firewall, proxy or DNS problem on the Host is the usual cause. Try again once it’s fixed, or install tmux instead.

No curl

herdr’s installer downloads with curl. Install it with your package manager, for example sudo apt install curl or sudo dnf install curl, then try again.

No supported package manager

Waycar couldn’t find a package manager it can run for tmux. Install tmux yourself using your system’s own tools, or install herdr. herdr doesn’t use a package manager.

Unsupported system

herdr’s installer supports Linux and macOS on x86_64 and aarch64. It stops on other systems, including Android with Termux. Use tmux 3.2 or later if your system packages it, or point Waycar at a supported machine.

After the install

• In Waycar, tap Check Again. Waycar says the tool is installed only after it finds it on the Host.
• herdr Hosts also need SSH stream-local forwarding. See Requirements.
• To get agent status, alerts and Chat Mode working, run the Waycar install command on the Host.
• Not sure which to pick? See herdr vs tmux.