Access your Herdr sessions from another computer through the native terminal interface. Herdr Relay supports macOS and Linux, encrypted pairing, multiple shared sessions, and background sharing with automatic reconnect.
Install Herdr latest on both computers. Herdr Relay supports compatible native Herdr clients without pinning a release number; 0.9.3 and 0.9.4 have been tested together. See Herdr compatibility.
Get Herdr Relay from the GitHub Releases (or the faster download site) or install it with Rust 1.99 or newer:
cargo install herdr-relay --lockedOn the computer you want to access, start herdr, then detach with Ctrl-B,
release, Q. Start sharing:
herdr-relay serveSelect sessions with Space, press Enter, and copy the pairing link. The background service is installed and started automatically.
On the other computer:
herdr-relay pairPaste the link and choose a host and session. For later connections, just run
herdr-relay. The default hosted Relay requires no account or Cloudflare setup.
When both computers share a LAN or tailnet, Herdr Relay connects directly with
the same end-to-end encryption and falls back to the relay otherwise; the host
menu shows which path each host uses. Allow TCP port 47120 on the host's
firewall to use it. On macOS, the app running herdr-relay may need Local
Network permission.
Herdr Relay needs no configuration. To change a default permanently, such as a
self-hosted Relay's origin or the Herdr executable, save it in config.toml
(~/.config/herdr-relay/config.toml by default):
herdr-relay config set origin https://relay.example.com
herdr-relay config set token # a self-hosted Relay's access token, entered hidden
herdr-relay config showFlags and environment variables still override the file. The hosted Relay never uses a token. See the configuration guide for every setting.
Choose a shared session by name, then connect to its agent workspace.
Terminal views rendered from real demo output.
- First connection: English · 中文教程
- Installation and background services
- Configuration and
config.toml - Updates and autostart
- Sleep protection and MacBook lid-close limits
- Host your own Relay
- Relay development · Protocol
MIT. Binary releases and the crate are public, along with this source repository.