Troubleshooting

• Check the phone and computer are on the same Wi-Fi, and not a guest network that isolates devices.
• On the iPhone, allow Local Network for AI Agent Remote in Settings → Privacy & Security → Local Network.
• Start the bridge with herdr-remote up (or serve --discoverable), not with --no-discovery.
• On Linux, install avahi-utils and make sure the avahi daemon is running.
• Still nothing? Pair with a QR code instead: herdr-remote pair --scope control --qr.

The code appears in the terminal running the bridge, as a desktop notification and in Herdr. If you missed it, tap Show a new code on the phone. Codes expire after two minutes or five wrong tries.

Cancel. Something other than your computer answered. Pair with a QR code shown on the computer itself, ideally on another network.

Invitations are single-use and last five minutes by default. Run herdr-remote pair again, or use --ttl for longer (up to an hour).

Remove the download quarantine from the kit folder once:

xattr -dr com.apple.quarantine ~/agent-remote

Another bridge is running with the same state, perhaps as a service. Stop it first, or run a second bridge with its own --state directory and port.

Run the bridge in a Herdr tab, or tell it where Herdr is with --herdr "$(which herdr)". Services have a shorter PATH than your shell. No Herdr at all? Use --backend plain.

Choose another with --port when the state is first created, or change Phone API port in the console. Paired phones are told about the change.

The bridge logs to the terminal it runs in. As a Linux service: journalctl --user -u herdr-remote -f. Logs contain events, not tokens, prompts or file contents.

The home address (yourcomputer.local or a 192.168… address) can’t be reached from elsewhere. Set up a VPN, a relay or app-only WireGuard, then pair again so the phone learns the route.

• Check herdr-remote relay status and that you restarted the bridge after joining.
• Your HTTPS proxy must forward /v1/host and /v1/tunnel with WebSocket upgrades.
• Behind a corporate proxy, set HTTPS_PROXY; if it inspects TLS, put its root certificate in NODE_EXTRA_CA_CERTS.
• If the relay was rotated, join again with the new profile.

A relay started with --personal-only admits only per-device credentials. Phones paired before bridge 0.1.25, and the Android app, still use the shared secret: pair them again, or run the relay without --personal-only for now.

Renewed certificates are picked up automatically by phones that connect before the switch. Otherwise, pair again with a fresh invitation. Never try to turn off certificate checks.

The device may be paired read-only (pair again with --scope control), or another device controls the pane: choose Take over from the ⋯ menu.

The connection dropped while sending. Look at the terminal before sending again: the app never resends uncertain input by itself, because the agent may already have received it.

Conversation history is available for Claude Code, Codex, Pi and Qwen Code when the bridge can find the agent’s session. The app says why when it falls back. Herdr keeps at most 1,000 lines of terminal history.

Transcription happens only on the phone. If your device doesn’t support on-device speech for the chosen language, choose another language or type; check that the app has microphone and speech recognition access in Settings.

iOS doesn’t keep connections open in the background. The app holds on for about 20 seconds, then releases control; when you return, it reconnects and opens where you were.

No. The app has no subscription or in-app purchase, and the bridge is free and open source. Your coding agents and model providers bill you as they do today.

No. The phone talks to your computer directly or through a relay you run, encrypted end to end to your computer. There is no Crow account, and the app has no analytics. See the privacy policy.

The bridge runs on macOS and Linux. Windows is not supported yet.

No. AI Agent Remote is an independent companion project by Crow Tech.

See Help & support or email [email protected] with the app and bridge versions, your device, and what happened. Leave out tokens, QR codes, invitations, relay profiles and private code.