RoamRun

Run your iOS apps wherever your device is.

デバイスがどこにあっても、iOS アプリを実機で。

A macOS menu bar app that makes Xcode's wireless debugging work over Tailscale. Your iPhone, iPad or Apple Vision Pro can be on another network — a café, a hotel, another phone's hotspot — and Xcode still sees it as a local device.

Xcode のワイヤレスデバッグを Tailscale 越しに使えるようにする、macOS のメニューバーアプリです。iPhone・iPad・Apple Vision Pro が別のネットワーク（カフェ、ホテル、別の端末のテザリングなど）にあっても、Xcode からは手元のデバイスとして見えます。

Installインストール GitHub
RoamRun main window: an iPad ready for Xcode over Tailscale

What you get

できること

Xcode, as usual

いつもの Xcode のまま

Run, install and stop at breakpoints on a device that is miles away. No Xcode plug-ins or project changes.

遠く離れたデバイスで、実行・インストール・ブレークポイントでの停止まで。Xcode のプラグインやプロジェクトの変更は不要です。

A CLI for you and your agent

人にも AI エージェントにも CLI

roamrun up, status, run, logs, doctor — over SSH too. An agent skill teaches Claude Code, Codex and others how to use it.

roamrun up・status・run・logs・doctor を SSH 越しでも。Claude Code や Codex などに使い方を教えるスキルも入れられます。

See and operate the device

実機を見て、操作する

roamrun look, tap, swipe, type, press — the real device's screen and input, from the command line or as MCP tools for an agent. iOS 27 or later; it needs neither the bridge nor Xcode. More

roamrun look・tap・swipe・type・press で、実機の画面を見て操作できます。コマンドからでも、AI エージェント向けの MCP ツールとしても。iOS 27 以降が必要で、ブリッジも Xcode も要りません。詳しく

A Mac the device was never near

デバイスのそばにいたことのない Mac でも

Pair a Mac in a data centre, or an agent's, with your device without ever bringing them together: another Mac, a Windows or Linux machine, or the device itself introduces them over Tailscale. iOS 27 and Xcode 27. More

データセンターの Mac や AI エージェントの Mac を、デバイスのそばに一度も置かずに、デバイスとペアリングできます。仲介するのは、別の Mac、Windows や Linux のマシン、またはデバイス自身です。通信は Tailscale 経由で行います。iOS 27 と Xcode 27 が必要です。詳しく

Install over the air

OTA でインストール

roamrun ota puts a build on a page the device opens in Safari. No bridge, no pairing, and cellular will do — it installs, and doesn't debug. More

roamrun ota で、ビルドをデバイスの Safari から入れられます。ブリッジもペアリングも要らず、モバイル回線でも使えます。できるのはインストールだけで、デバッグはできません。詳しく

Hands off your traffic

通信の中身には触れません

RoamRun only relays bytes; pairing and encryption stay end to end between the Mac and the device. Developer ID signed, notarized by Apple.

RoamRun はバイト列を運ぶだけで、ペアリングと暗号化は Mac とデバイスの間で完結します。Apple の公証済みです。

How it works

仕組み

  1. Xcode looks for devices with Bonjour on the local network. RoamRun publishes your device's record there, pointing at the Mac itself.
  2. Xcode connects to the Mac; RoamRun's relay accepts only connections from this Mac.
  3. The relay forwards the traffic to the device over Tailscale.
  1. Xcode は、LAN 上のデバイスを Bonjour で探します。RoamRun は、デバイスの情報を「この Mac が相手」として LAN に出します。
  2. Xcode は Mac 自身に接続し、RoamRun の中継がそれを受けます（この Mac からの接続だけ）。
  3. 中継が、その通信を Tailscale 経由でデバイスに届けます。

Install

インストール

brew install --cask mh-mobile/tap/roamrun

Or download the dmg from GitHub Releases. Then add your device once in the app, while it's on the Mac's Wi‑Fi (or USB), and start a bridge. Full guide: README.

On a Windows or Linux machine (or a Mac without RoamRun) that is to introduce a device to a far Mac: roamrunctl, with each release.

GitHub Releases から dmg をダウンロードしても構いません。インストール後、デバイスを Mac と同じ Wi‑Fi（または USB）につないだ状態でアプリから一度登録し、ブリッジを開始します。詳しくは README をどうぞ。

ペアリングを仲介するマシンが Windows や Linux のマシン（または RoamRun を入れていない Mac）の場合は、roamrunctl を使います。リリースごとに配布しています。

Requirements

必要なもの