Quickstart

Run one command on the computer you want to control:

npx muxr setup

muxr checks an existing compatible herdr install, opens the fixed activation page, and prints the same URL and short code for headless use. Verify one email OTP, compare the machine details, approve, and scan the short-lived QR in the mobile app.

macOS and Linux

Use a normal terminal. Setup adopts herdr without replacing its configuration and installs the user daemon after authorization.

WSL

Run setup inside WSL. The daemon and herdr remain inside that Linux environment.

SSH

Use npx muxr setup --headless. Open the printed fixed URL on another device and enter the printed short code. No callback port or token copy is required.

Termux

Run the same setup command. Verified package-targeted activation is used where available; otherwise use the printed fixed URL and code.

Pair another phone

muxr pair

The QR expires after five minutes and grants only this machine.

Daemon and uninstall

Use muxr daemon status for status and muxr daemon logs for redacted logs. muxr daemon uninstall removes only the daemon registration. muxr integrations uninstall removes only muxr-managed integration files and blocks. Local machine keys and herdr work are retained unless you explicitly remove them.