ノートPCはエディタとブラウザーです。コード、サービス、エージェントはサーバー上に残ります。
あなた専用の tailnet
ノートPCとサーバーは、お客様の Tailscale アカウントに属するプライベートな Tailscale ネットワーク上で通信します。rdev がそこに参加することはありません。インストーラーはアカウントのキーを使ってサーバーを接続し、ノートPCアプリがノートPCを接続します。
ファイル同期
rdev が、ノートPCとサーバーの間でプロジェクトファイルを双方向に同期します。node_modules、vendor、ビルド出力など、転送する必要のないフォルダーは最初から除外されます。
同期する内容は、パネルの ダッシュボード > お客様のサーバー > 設定 で選択します。
- ノートPCに同期: オフにすると完全リモートで作業できます。ノートPCには何もコピーされず、エディタは SSH(
ssh rdev、VS Code や Cursor の Remote-SSH、PhpStorm Gateway)でプロジェクトを開きます。サイトと.dev.testは引き続き動作します。 - ノートPC上のプロジェクト: チェックを外すと、そのプロジェクトはサーバー上にのみ残ります。ノートPC上にすでにあるコピーはそのまま残るので、不要になったら削除してください。後でそのプロジェクトが再び同期されるときは、ノートPC上の古いコピーが先に
~/Code-rdev-old/に移動され、サーバーのコピーがダウンロードされます。 - 未同期: 既定の除外項目(それぞれオフにできます)と、
.gitignoreに似た構文で追加するお客様独自のパターンです。
ノートPCは数分以内に新しいルールを適用します。すぐに適用するには rdev laptop sync を実行してください。
エディタとブラウザー
同期されたファイルに対して、VS Code や PhpStorm など、使い慣れたエディタを使います。サイトは普段のブラウザーで https://<name>.dev.test から開きます。ノートPCアプリが、これらのアドレスの名前解決と信頼された証明書を設定します。
ファイル共有
サーバー上のターミナルにはファイルを貼り付けられないため、rdev はエージェントに共有フォルダーを用意しています。ノートPCの ~/rdev-share に置いたものは、ファイル同期がオフでも、数秒でサーバーの ~/Share/<laptop name> にコピーされます。ノートPCごとに専用のフォルダーがあるため、複数のノートPCから同時に共有できます。エージェントに「最後のスクリーンショットを見て」や「今送ったファイルを開いて」と頼むと、最新のものを開きます。画像、PDF、ログ、エクスポートなど、どんな種類のファイルでも使えます。
- アプリの クリップボードを送信(メニューバーまたはトレイのアイコンにもあります)は、Finder、エクスプローラー、ファイルマネージャーでコピーしたファイルを、なければクリップボードの画像を送信します。サーバーに届くまで待って、サーバー上のパスをクリップボードに入れます。それをエージェントに貼り付けてください。ターミナルでは
rdev laptop share sendまたはrdev laptop share send <files>を使います。 - アプリのウィンドウに ファイルをドロップ しても、同じように送信できます。
- 逆方向: エージェントがサーバーの
~/Share/<laptop name>/outに置いたファイルは、ノートPCの~/rdev-share/from-serverに届きます。エージェントに「レポートを out に置いて」と頼んでください。 - macOS のスクリーンショットをここに保存 にすると、Shift-Command-3、4、5 で
~/rdev-shareに保存されます(rdev laptop share macos)。Shottr や CleanShot などのスクリーンショットアプリも、ここに保存できます。 - ファイルは両側で7日後に削除されます。アプリの ファイルの保持日数 または
rdev laptop share keep <days>で変更できます(0 で削除しません)。keepフォルダー内のファイルは削除されません。 - 500 MB を超えるファイルは送信されません。
scpまたはrsyncで移動してください。すべてサーバーに直接送られ、rdev.cloud を経由することはありません。アプリのスイッチまたはrdev laptop share offで共有をオフにできます。
1.2.0 より前はスクリーンショットフォルダーでした。~/rdev-shots は ~/rdev-share に、~/Shots は ~/Share に自動で移動し、~/Shots はリンクとして引き続き使えます。
対応するノートPC
ノートPCアプリと rdev laptop は、macOS(Apple シリコンと Intel)、Linux(x64 と ARM64)、Windows 10 と 11(x64 と ARM64)で動作します。アプリは ダウンロードページ から入手できます。Linux では、代わりにコマンド1つでインストールすることもできます。Debian と Ubuntu では .deb、Fedora では .rpm、それ以外(たとえば Arch や CachyOS)では AppImage が使われます:curl -fsSL https://rdev.cloud/install | sh -s -- app。AppImage は ~/.local/bin に置かれてアプリケーションメニューに表示され、ファイルを移動してもアプリがそのエントリをファイルに向け続けます(1.4.4 以降)。.deb を自分でダウンロードした場合は、/tmp からインストールしてください(sudo apt install /tmp/rdev-linux-arm64.deb、または -x64)。ホームフォルダーからでも apt は動作しますが、サンドボックスユーザーがファイルを読めないという注意が表示されます。Linux では、rdev は多くのディストリビューションが使う systemd-resolved を通じて *.dev.test をサーバーに向けます。一部の仮想マシンイメージのように無効またはマスクされている場合は、rdev laptop connect がそのことを表示し、有効にする方法を示します:sudo systemctl unmask systemd-resolved && sudo systemctl enable --now systemd-resolved、続けて sudo ln -sf /run/systemd/resolve/stub-resolv.conf /etc/resolv.conf を実行し、もう一度接続してください。NetworkManager が、動作中の systemd-resolved とは別に独自の /etc/resolv.conf を保持していると(Tailscale は両者が「wired together incorrectly」だと報告します)、名前解決が rdev の経路に届きません。rdev laptop connect と rdev laptop status がそのことを表示し(1.4.4 以降)、同じ ln -sf コマンドで解消できます。rdev は Debian、Ubuntu、Fedora、openSUSE、Arch、CachyOS で、システムの信頼済み証明書に自分の証明書を追加します。1.4.4 より前は、Arch と CachyOS では接続がそこで止まっていました。
接続の手順
- ノートPCに Tailscale をインストールし、サーバーと同じ Tailscale アカウントでログインします。Linux ではこの手順は省略できます。Tailscale がない場合、
rdev laptop connectが Tailscale の公式リポジトリからインストールしてサインインを開始し、ブラウザーで完了します。 - ノートPCに rdev をインストールして接続します。ご自身のユーザーでターミナルから次を実行し、求められたらノートPCのパスワードを入力してください。rdev のインストール、証明書の信頼、名前解決の設定に必要です。
curl -fsSL https://rdev.cloud/install | sh -s -- laptop
rdev コマンドがインストールされ、rdev laptop connect が実行されます。これは tailnet 上でサーバーを見つけ、SSH 設定に rdev エントリを追加し、環境の証明書を信頼し、*.dev.test をサーバーに向け、~/Code フォルダーをサーバーの ~/Code と同期し始めます。
事前にほかのものをインストールする必要はありません。ファイル同期ツールがない場合、rdev はバージョン固定でチェックサム検証済みのコピーを ~/.local/share/rdev/bin にインストールします。すでにお持ちのものはそのまま使われます。Linux では、スクリーンショットに使うクリップボードツール(wl-clipboard、xclip)と、Chrome に証明書を登録する certutil も、パッケージマネージャー経由で同じパスワード入力のもとにインストールされます。インストール時にサーバーに別の名前を付けた場合は --server <name> を、別のフォルダーを同期する場合は --code-dir <folder> を追加してください。セットアップをやり直したいときは、rdev laptop connect を再度実行します。
rdev laptop connect はパスワードを尋ねる前に、同期しようとしているフォルダを確認します。別の同期セッションがそのフォルダ(またはそれを含むフォルダ)をすでに同期している場合は停止して --code-dir <フォルダ> を提案します(rdev でも同期すると 3 台の間ですべてがコピーされるため)。それでも同期するには --force を付けて実行するか、アプリで このまま同期する を選んでください。5 GB を超えるフォルダも接続でき、最初の同期に時間がかかる旨が表示されます(rdev 1.1.10 以降。それ以前は停止していました)。
すでに dev.test を別の場所(たとえば別の開発サーバー)に向けている Mac では、rdev はその設定を退避しておき、接続解除またはアンインストール時に元に戻します。
Windows では、上の curl コマンドは使えません。 ダウンロードページ からアプリをインストールし、アプリから接続してください。ノートPCアプリ 1.4.2 以降では、アプリが rdev コマンドも %USERPROFILE%\.local\share\rdev\bin にインストールし、そのフォルダーを PATH に追加します。使うには新しいターミナルを開いてください。管理者権限は不要で、アプリと一緒に更新されます。
ファイルが同期されているのにアプリに Check connection が表示され続け、rdev laptop status が *.dev.test resolves to …, not the server と表示する場合は、Tailscale 管理コンソールの DNS ページを確認してください。dev.test を別のマシン(たとえば古いサーバー)に向ける split DNS エントリがあると、Windows では rdev の設定より優先されます。そのエントリを削除するか、サーバーを指すように変更してください。
接続はいつでも rdev laptop status で確認できます。rdev laptop disconnect は同期を停止して設定を削除します。ファイルは両側に残ります。
ノートPCから rdev を削除する
rdev laptop uninstall
接続を解除し、環境の証明書の信頼を取り消し、rdev コマンド、その設定、インストールしたツールを削除します。同期したフォルダーと ~/rdev-share は残ります。rdev がインストールした同期ツールも、ほかの同期セッションがまだ使っている間は残ります。ノートPCのパスワードを一度求められ、rdev 0.2.0-beta.21 以降が必要です。
ノートPCはサーバーにログインできる必要があります。インストーラーは、インストール時にサーバーにログインできた SSH 鍵をコピーします。別のノートPCを追加するには、パネルのサーバーのページの SSH 鍵 で、その公開鍵を追加してください(1行に1つなので、複数のコンピューターを一度に追加できます。追加時に「仕事用ノートPC」のような名前を付けられ、付けない場合は鍵の末尾の名前が表示されます)。サーバーは数秒でそれを許可します。この機能には rdev 0.2.0-beta.33 以降が必要です。それ以前は、サーバーの /opt/rdev/home/.ssh/authorized_keys に鍵を追加してください。rdev laptop connect がログインできないと表示した場合は、これが不足しています。
接続できたら、ssh rdev でサーバーのターミナルを開いてエージェントを起動し、ブラウザーで https://<folder>.dev.test からサイトを開きます。 rdev open <プロジェクト> は、永続セッション内でサーバー上のプロジェクトフォルダに直接ターミナルを開きます。名前を省くとプロジェクト一覧を表示します(rdev 1.1.11 以降)。
Mac アプリ
入力よりクリック派ですか?Mac 用 rdev アプリ(Apple シリコンと Intel、Apple の署名と公証済み)をダウンロードし、アプリケーションにドラッグして開いてください。ノートPCが接続されているかどうかを表示し、ボタン1つで接続と切断ができ、サーバーのターミナルを開けます。rdev laptop connect と同じセットアップを行うため、必要なのは Tailscale(手順1)だけで、コマンドは不要です。同期ツールはアプリ自身がインストールします。接続する前に、プロジェクトの同期先フォルダー(既定は ~/Code)を変更できます。これは --code-dir に相当するアプリの設定です。
初めて開くと、アプリが設定を一歩ずつ案内し、すべての手順が成功するまでタブは開きません。rdev アカウントでサインインし、Tailscale がインストール済みでログインしているか確認し、アカウントのサーバーを選び、このノートPCを許可し(アプリが SSH 鍵をサーバーに追加し、鍵がなければ作成します)、参照… でプロジェクトの同期先フォルダを選んで接続します。 あとから Sites タブの サーバーを変更 で、別のサーバー向けにノートPCを設定し直せます。ノートPCのサーバーがなくなった(接続できない、またはアカウントにない)場合はアプリがそれを知らせ、設定し直す を提示します。どちらの場合もファイルはそのまま残ります。rdev コマンドがアプリより古いときは、About に更新コマンドをターミナルで開く ターミナルで実行 ボタンが表示されます。
アプリには7つのタブがあります。
- サイト:
https://<name>.dev.testのリンクとしてのプロジェクト、サーバーのターミナル、共有ファイル。 各サイトには Open in Terminal があり、サーバー上のそのプロジェクトのフォルダーでターミナルを開きます。 Sites タブには、捕捉したメールとダンプのページを開く Mail と Dumps ボタンもあります。Web terminal ボタンもあり、Webターミナルを開きます。 エラートラッキングを開く Errors ボタンもあります。 - 同期: パネルと同じ設定(同期のオンとオフ、このノートPC上のプロジェクト、除外)。保存するとこのノートPCにすぐに適用されます。
- Env: サーバー上のプロジェクトの
.envを読み取り、変更します。アプリは SSH 接続で動作するため、現在の値が表示され、値が rdev.cloud を経由することはありません。 - Gotify: 通知 が Gotify サーバーに送られる場合、アプリがそれを待ち受け、各メッセージをサウンド付きのデスクトップ通知として表示します。サーバーのアドレスとクライアントトークン(Gotify の Clients)を入力します。テストメッセージを送るには、アプリケーショントークン(Gotify の Apps)を追加します。トークンはこのノートPCにのみ保存されます。
- 連携: サーバーの Git アクセス。サーバーキー、GitHub、GitLab、Bitbucket などのアカウントをいくつでも(それぞれ専用の SSH 鍵またはトークン付きで)、信頼待ちのホスト、アクセステスト。トークンは SSH 経由でサーバーに送られ、rdev.cloud を経由することはありません。
- 設定: サーバーのターミナル が開くターミナルアプリ(Terminal、iTerm2、Warp など、インストール済みのもの。変更するまで保持されます)、メニューバーアイコン(ライトまたはダークのメニューバーに合わせるモノクロ、またはカラーのアプリアイコン)、スクリーンショット同期、アカウント。rdev.cloud でサインイン を選び、ブラウザーでパスワードを確認し、同じコードが表示されていることを確認して承認します。サインイン済みのアプリは、パネルの 設定 > 連携アプリ に一覧表示され、連携を解除できます。
- 情報: アプリと
rdevコマンドのバージョン、rdev.cloud 上の最新のアプリ。
内蔵ターミナル
Terminal on the server は rdev の内蔵ターミナルを開きます。サイズ変更、最大化、フルスクリーンができる独立したウィンドウで、次回は前回のサイズで開きます。ssh rdev でログインし、サーバーの永続セッションに参加するので、ウィンドウを閉じてもネットワークが切れてもエージェントは止まりません。接続が切れると自動で再接続し、作業していた場所に戻ります。
- コピーと貼り付け: macOS では Cmd-C と Cmd-V、Linux と Windows では Ctrl-Shift-C と Ctrl-Shift-V。サーバーでコピーしたテキスト(vim などで)はノートパソコンのクリップボードに入ります。スクリーンショットがオンなら、画像を貼り付けるとサーバーに送られ、そのパスが貼り付けられるので、そのままエージェントに渡せます。
- Shift-Enter で Claude Code のプロンプトに改行を入れます。
- 検索は Cmd-F(Linux と Windows では Ctrl-Shift-F)、文字サイズは Cmd と +、−、0(Linux と Windows では Ctrl)で変えます。
- リンクはブラウザーで開きます(
https://<名前>.dev.testのサイトも含む)。ウィンドウが背面にあるときにターミナルがベルを鳴らすと(エージェントが応答を求めたときなど)、デスクトップ通知が届きます。 - Open in an external terminal は同じセッションをターミナルアプリで開きます。Terminal on the server の隣のボタン、メニューバーアイコンのメニュー、または内蔵ターミナルで Cmd-Shift-O(Ctrl-Shift-O)を使います。ターミナルアプリを既定にするには Settings で選びます。 使うアプリは Settings の External terminal で選びます。最初は以前選んだターミナルアプリ、なければ Mac ではターミナルです。
アプリは、起動時、6時間ごと、情報 を開いたときに新しいバージョンを確認します。ある場合はタブの上のバーでお知らせします。更新 を選ぶと、アプリがダウンロードし、署名を確認し、インストールして再起動します(Linux では .deb と .rpm がパスワードを求め、Windows ではインストーラーが自動で実行されます)。アプリ内での更新には 0.2.0-beta.34 以降が必要です。それより古いバージョンは、一度手動で上書きインストールしてください。 ノートパソコンの rdev コマンドは別に更新します。インストールコマンド curl -fsSL https://rdev.cloud/install | sh -s -- laptop をもう一度実行してください。Windows ではアプリに同梱され、アプリと一緒に更新されます。コマンドがアプリより古いときは、About にこのコマンドがコピーボタン付きで表示されます。
ウィンドウを閉じても rdev はメニューバーに残り、Dock と Cmd-Tab からは消えます。終了するには、メニューバーアイコンのメニューの 終了、または Cmd-Q を使います。
Settings(ノートPCアプリ 1.4.3 以降)では、Open at login がサインイン時に rdev をバックグラウンドで起動し、そのままメニューバーまたはトレイに常駐させます。Keep running when the window is closed(デフォルトでオン)は、ウィンドウを閉じたときに rdev をそこに残すか終了するかを決めます。オンの間は、ウィンドウを閉じていてもファイル同期と通知は動き続けます。GNOME はトレイアイコンを AppIndicator 拡張機能がある場合にのみ表示します(Ubuntu には入っています)。拡張機能がないと、ウィンドウを閉じたあとにクリックできるアイコンが残らないため、アプリメニューから rdev をもう一度開いてください。アプリは Settings(ノートPCアプリ 1.4.4 以降)でこのことを警告します。サインイン時の起動に管理者権限は不要です。rdev は自分のユーザーにだけログイン項目を追加します(macOS では launch agent、Linux では autostart エントリ、Windows ではユーザーのレジストリの Run エントリ)。
アプリは、起動している間、5分ごとにパネルの同期ルールも適用します。
Firefox は独自の証明書リストを持っています。Linux では、rdev は Chrome と、見つかったすべての Firefox プロファイル(Ubuntu が提供する snap 版の Firefox と Flatpak 版を含む、rdev 0.2.0-beta.34 以降)に証明書を追加します。その後、Firefox を再起動してください。後から作成した Firefox プロファイルや、macOS と Windows では、設定 > プライバシーとセキュリティ > 証明書 で ~/.config/rdev/ca.pem をインポートしてください。