rume has two parts. The daemon runs on the machine you want to control (macOS or Linux). The client runs on your phone or laptop — grab it below, or just open it in Telegram.
Desktop builds aren't code-signed yet, so macOS/Windows may warn “unknown developer”. See how to open them — it's safe.
Run this on the Mac or Linux box you want to reach. It installs a background service, generates a secret token, and prints a pairing link — no config needed.
The script detects your OS/arch, verifies a SHA-256 checksum, and installs a per-user service (launchd or systemd) — no root required. Full walkthrough in the installation guide →
The daemon needs macOS or Linux (it uses tmux & unix PTYs). On Windows you can still run the client above and reach a daemon running on another machine.
When the script finishes it prints a rume://pair link and a one-tap Telegram link. Keep that terminal open.
Open the app you downloaded (or the Mini App) and paste rume://pair — or just tap the printed t.me link.
Your shells and Claude Code are live. The pairing syncs to every device signed into the same Telegram account.
Prefer signing in with an account instead of pairing? See the quickstart →
Desktop builds aren't code-signed yet. The download is safe — just tell the OS to open it:
macOS: right-click the app → Open → Open (once); or
xattr -dr com.apple.quarantine /Applications/rume.app
Windows: SmartScreen → "More info" → "Run anyway"
Signed & notarized builds are planned.
Sideloading needs one permission. When you open the .apk, Android asks to
allow installs from this source — enable it, then tap Install. (Settings ▸ Apps ▸ Special access ▸ Install unknown apps.)
The daemon runs your shells under tmux so they survive restarts. Install it:
macOS: brew install tmux Debian/Ubuntu: sudo apt install tmux Fedora: sudo dnf install tmux
For Claude Code, make sure node and claude are on the PATH line in ~/.rume/rume.env, then restart the service.
Neither is required to install, but the client needs a path to the daemon:
• Tailscale: put both devices on one tailnet — the app connects directly. • Relay (default for the Mini App): the daemon dials out to our relay; nothing to configure.
The installer sets up relay mode by default. To self-host over Tailscale instead, run rumed login --tailscale. More in Connectivity.
Run one command — it reprints the pairing link and a scannable QR code:
rumed pair
Or read it from the log (the daemon also prints it on every start):
macOS: tail -f ~/.rume/logs/launchd.err.log Linux: journalctl --user -u rumed -f
One command removes everything the installer added — the background service, the rumed binary, and ~/.rume (token, E2E key, logs, history). It also stops rume's tmux sessions but leaves your personal ones untouched.
More answers in the full troubleshooting guide →