Support

Setup help, FAQ, and how to reach a human.

Getting started

1. Install on the Mac

From a terminal, run:

• curl -fsSL https://github.com/hiletmis/remoude-public/releases/latest/download/install.sh | bash

It installs the hook, generates a pairing secret, registers the Claude Code hooks (backing up your settings first), and prints a pairing QR code.

2. Pair the phone

Install Remoude from TestFlight, open it, and paste the remoude://pair link the installer printed — or scan the QR with a reader that hands custom URL schemes to the system. Allow notifications; the push token publishes itself.

3. Use it

remoude on when you leave the desk, remoude off when you’re back. Restart any running Claude Code session once after setup so it loads the hook.

Frequently asked

The Camera app says “no usable data found” when I scan the QR.

iOS Camera only opens http(s) and a few known schemes, so it won’t open remoude://. Scan it with a QR reader that passes custom URLs to the system, or paste the remoude://pair link the installer printed directly into the app.

Nothing arrives on my phone.

Check that away mode is on with remoude status, that you restarted Claude Code after setup, and that notifications are allowed for Remoude in iOS Settings. remoude log shows what the hook has been doing.

What happens if I don’t answer?

After about 9.5 minutes the hook steps aside and the normal local permission prompt appears on the Mac — a session is never bricked. Questions (multiple-choice) similarly fall back to the Mac’s own picker.

Which tool calls get forwarded?

By default Bash, Write, Edit, and NotebookEdit. Adjust the tools list in ~/.remoude/config.json to intercept more or fewer.

Can I run my own server?

Yes. Set REMOUDE_RELAY=https://my-relay at install to self-host the message relay. The relay, hook, and cryptography are open source. The one hop you can’t fully self-host without building the app yourself is Apple’s push wake-up, which sees only an encrypted blob and a device token. See the self-hosting guide for the full picture.

How do I review or revoke remembered approvals?

remoude approvals list shows them; remoude approvals clear goes back to asking every time. Rules are keyed byte-exact and denials are never remembered.

How do I uninstall?

remoude uninstall unregisters Remoude’s hooks (backing up your settings), then deletes ~/.remoude. Delete the orphaned pairing in the iPhone app afterward.

Still stuck?

Send a message and it lands in our inbox — no account, no tracking. Or reach us directly at info@remoude.com or on GitHub.