Waycar Support

Waycar is an iPhone and iPad app for herdr and tmux. It connects to computers you control, called Hosts, over SSH or mosh, and shows the Agents running there. Waycar is made by OTREVA, LLC.

For how each feature works, step by step, see Waycar Help: one page per feature, with fixes for common problems.

Contact us

Email support@waycar.dev. We answer every message by email.

For discussion, bugs, and feature requests, join the community at r/waycar on Reddit.

Please tell us your iPhone or iPad model, its iOS version, the Waycar version (Settings › About), and what you see on screen. Never send passwords, private keys, tokens, or other secrets.

For privacy questions or data requests, email privacy@waycar.dev.

What you need

• An iPhone or iPad with iOS or iPadOS 18 or later.
• A Mac or Linux computer you control (a Host) running herdr 0.7.5 or later, or tmux 3.2 or later. See herdr.dev.
• SSH access to that Host. On a Mac, turn on Remote Login in System Settings › General › Sharing.
• Optional: Node 20 or later and Waycar's tools (the install command below), for Scan to Pair, Agent Notifications, Live Activities, Chat Mode, and status hooks.
• Optional: mosh-server on the Host, for connections that survive network changes.

Set up

1. Install herdr on your Host and start it, or have tmux 3.2 or later on the Host.
2. Add the Host to Waycar in one of two ways.

Scan to Pair (uses Waycar's tools)

1. On the Host, run: curl -fsSL https://waycar.dev/install.sh | sh

The same command works for herdr, tmux, or both. It needs Node.js 20 or later, curl, and tar. It does not use sudo. 2. Answer Y when it offers to show a Pairing Code. On herdr it pops up inside herdr. On tmux it draws in your terminal. Press c if you want to copy the code instead. On a Mac Host that copies it. On a Linux Host it shows the code so you can select it. The code expires in about 2 minutes. 3. In Waycar, tap Scan to Pair and scan the code, or tap Paste Pairing Code. The Pairing Code carries the Host's local network addresses, so keep your device on the same network while you pair. 4. Run the command again whenever you want to pair another device.

Add Manually (no install needed)

1. In Waycar, tap Add Manually on the welcome screen, or + (Add Host) in the Hosts list.
2. Enter the Host's Address (a DNS name such as mac.example.com works best), Port (usually 22), and User.
3. Under Authentication, choose a Method:
   • Password: type your login password for that user.
   • Device Key: copy the line Waycar shows and add it to ~/.ssh/authorized_keys on the Host.
4. Tap Save. When Waycar asks Trust this Host?, check the fingerprint (see "Host key" below) and tap Trust.
5. Waycar runs its checks. When they pass, your Agents appear in the Console.

Waycar Pro and billing

• Waycar is free with 10 Launches in any rolling 30 days. A Launch is starting a new agent or shell from Waycar, resuming a closed agent, or starting an agent by typing its command in a Waycar shell. Opening and reading sessions that are already running never counts.
• Waycar Pro removes the limit. It is an auto-renewing subscription: $5 a month or $40 a year in the United States. Prices in other countries are shown in the app before you buy.
• Payment is charged to your Apple Account. The subscription renews automatically unless you cancel it at least 24 hours before the end of the current period.
• To see Waycar Pro without using a Launch: Waycar › Settings › Subscription › See Waycar Pro.
• Cancel or change your plan: on your iPhone or iPad, open Settings, tap your name, then Subscriptions, then Waycar. Or open apps.apple.com/account/subscriptions, or use Waycar › Settings › Subscription › Manage Subscription. Apple's instructions: support.apple.com/en-us/118428.
• Refunds are handled by Apple, not by us. Request one at reportaproblem.apple.com.
• Restore Pro on a new device: sign in with the same Apple Account, then tap Waycar › Settings › Subscription › Restore Purchases.
• An Agent you start by typing a command in a Waycar shell after your 10 free Launches keeps running on your Host, but its screen stays hidden in Waycar on that device until you get Waycar Pro. You can always see and stop it in herdr or tmux on the Host.
• Terms: Waycar is licensed under Apple's standard end user license agreement.

Common problems

Host key: "Trust this Host?", "The host key is not trusted", or "The host key changed"

Waycar pins each Host's SSH host key the first time you connect. To check the fingerprint Waycar shows, run this on the Host; one of the SHA256 values it prints must match:

for f in /etc/ssh/ssh_host_*_key.pub; do ssh-keygen -lf "$f"; done

If you see "The host key is not trusted", open the Host's page and answer Trust this Host?. If you see "The host key changed" and you did not reinstall or replace the Host, do not trust the new key: someone may be intercepting the connection. If you did, open the Host's page and choose Trust New Key.

"herdr is not running on this Host"

Start herdr on the Host. If it is running, check that SSH stream-local forwarding is allowed: Waycar talks to herdr through its socket over SSH. In /etc/ssh/sshd_config, AllowStreamLocalForwardingmust not be no and DisableForwarding must not be yes. The line in~/.ssh/authorized_keys must not contain restrict or no-port-forwarding. Restart SSH on the Host after a change.

"herdr is not on this Host's SSH PATH"

SSH commands do not load your full shell profile. Homebrew installs herdr in /opt/homebrew/bin(Apple silicon Mac) or /home/linuxbrew/.linuxbrew/bin (Linux). Make sure that folder is on the PATH for non-interactive SSH sessions.

"tmux is not installed on this Host"

Install tmux 3.2 or later, or herdr, on the Host.

"tmux is too old"

Waycar needs tmux 3.2 or later. Update tmux on the Host. If the Host also runs herdr, the install command ignores an old tmux and sets up herdr. Without herdr, it stops and tells you tmux is too old.

tmux Isn't Running on your Host

tmux has no sessions yet. Tap Start Session in the Console to start one, or start one on the Host.

Agents show Unknown on tmux

Waycar's status hooks tell it when an Agent is Working, Blocked, or Done. Claude Code, Codex, omp, pi and opencode, listed in Waycar hooks for tmux get hooks, but only if they were installed before you ran the install command. Run it again if you added one later. On the Host's page, Install Status Hooks does the same. Codex also needs a one-time review on its /hooks screen. Other Agents show Unknown.

One backend shows an issue on a Host with herdr and tmux

A Host can run both. If herdr or tmux fails, Waycar shows that issue with a Retry button while the other keeps working. To hide the tmux sessions on that Host, turn off Show tmux sessions on the Host's page. That also stops their notifications.

"Authentication failed"

Password sign-in uses SSH password authentication. If the Host only allows keys or keyboard-interactive sign-in, choose Device Key and add its line to ~/.ssh/authorized_keys.

Mosh does not connect

Mosh is optional. When it fails, Waycar uses SSH instead. To use mosh, install mosh-server on the Host (brew install mosh or sudo apt install mosh) and allow incoming UDP ports 60000 to 61000 through the Host's firewall and router. Then edit the Host and tap Test Mosh on this Host.

IPv6-only networks

Some cellular and guest networks offer only IPv6. Waycar works there with a DNS name or an IP address; type IPv6 addresses without square brackets.

Pairing Code: "The Host has no pairing in progress for this code"

The code expired or was already used. Run the install command again, or show a new Pairing Code in herdr. On tmux, run the pair command the install command printed. Then scan the new code.

My computer is not reachable from the internet

Add a Jump Host: a server that you can reach and that can reach your computer. Enter it in the Host's Jump Host section. Waycar checks host keys at both hops.

Privacy

Your SSH keys, passwords, commands, and terminal output go only between your device and your Hosts. If you turn on AI Summaries, your Host also sends recent screen text to its AI provider. Read the full privacy policy.

Company

Waycar is an independent app from OTREVA, LLC. It is not affiliated with or endorsed by the herdr project, CodexBar, Anthropic, OpenAI or Google.