Environment Setup

Set up your terminal and Herdr before first use — about 5 minutes, once only.

1. Set up a terminal

Windows 11 already includes a modern terminal: open the Start menu, search for "Terminal", and open it — nothing to install.

Windows 10 needs a one-time install: open the Microsoft Store, search for Windows Terminal (official, free), click Get, then open it.

Advanced option: WezTerm (wezterm.org) is excellent but configured by editing files, and Herdr's native Windows combination with it is not fully verified — beginners should stick with Windows Terminal.

2. Install Herdr

Paste the following command into the Terminal window and press Enter:

powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

If the command above is blocked by antivirus or security policy, use Command Prompt instead: press Win+R, type cmd, press Enter, then paste and run:

curl.exe -fsSLo install.cmd https://herdr.dev/install.cmd && install.cmd && del install.cmd

3. Verify the install

Close the terminal window completely, reopen it (so your system finds the newly installed command), then type:

herdr

If you see the Herdr interface, you're done — head back to the connection guide to continue.

Read this first (Windows)

If a blue warning saying "Windows protected your PC" appears the first time you run Herdr: click More info → Run anyway. Herdr's official binaries aren't code-signed yet — this is expected, not a virus.
In Herdr, paste with Ctrl+Shift+V, not Ctrl+V.
When typing with a CJK input method, the candidate window may occasionally appear in the wrong spot — it doesn't affect typing; this is a known quirk.