Votre ordinateur portable est l'éditeur et le navigateur. Le code, les services et les agents restent sur votre serveur.
Votre propre tailnet
Votre ordinateur portable et votre serveur communiquent via un réseau privé Tailscale qui appartient à votre compte Tailscale. rdev ne le rejoint jamais. L'installateur connecte votre serveur avec une clé de votre compte, et l'application pour ordinateur portable connecte votre ordinateur.
Synchronisation des fichiers
rdev garde les fichiers de vos projets synchronisés entre votre ordinateur portable et votre serveur, dans les deux sens. Les dossiers qui n'ont pas besoin de voyager, comme node_modules, vendor et les fichiers de build, sont ignorés dès le départ.
Vous choisissez ce qui se synchronise dans votre panneau, sous Tableau de bord > votre serveur > Paramètres :
- Synchroniser vers les ordinateurs portables : désactivez-le pour travailler entièrement à distance. Rien n'est copié sur l'ordinateur portable ; votre éditeur ouvre les projets via SSH (
ssh rdev, VS Code ou Cursor Remote-SSH, PhpStorm Gateway). Les sites et.dev.testcontinuent de fonctionner. - Projets sur les ordinateurs portables : décochez un projet pour le garder uniquement sur le serveur. Une copie déjà présente sur votre ordinateur portable est laissée en place, supprimez-la donc quand vous n'en avez plus besoin. Quand un projet se synchronise à nouveau plus tard, l'ancienne copie de l'ordinateur portable est d'abord déplacée vers
~/Code-rdev-old/et la copie du serveur redescend. - Jamais synchronisé : les exclusions par défaut, que vous pouvez chacune désactiver, plus vos propres motifs dans une syntaxe proche de
.gitignore.
Les ordinateurs portables appliquent les nouvelles règles en quelques minutes. Exécutez rdev laptop sync pour les appliquer immédiatement.
Éditeurs et navigateur
Utilisez l'éditeur que vous connaissez déjà, comme VS Code ou PhpStorm, sur les fichiers synchronisés. Ouvrez vos sites dans votre navigateur habituel à l'adresse https://<name>.dev.test ; l'application pour ordinateur portable configure la résolution de noms et un certificat de confiance pour ces adresses.
Partage de fichiers
Un terminal sur votre serveur ne peut pas coller de fichier, rdev donne donc à votre agent un dossier partagé. Tout ce qui se trouve dans ~/rdev-share sur votre ordinateur portable est copié vers ~/Share/<laptop name> sur le serveur en quelques secondes, même quand la synchronisation des fichiers est désactivée ; chaque ordinateur portable y a son propre dossier, plusieurs ordinateurs peuvent donc partager en même temps. Demandez à votre agent de « regarder la dernière capture d'écran » ou d'« ouvrir le fichier que je viens d'envoyer » et il ouvre le plus récent. Tout type de fichier fonctionne : images, PDF, logs, exports.
- Envoyer le presse-papiers dans l'application (aussi dans l'icône de sa barre des menus ou de la zone de notification) envoie les fichiers que vous avez copiés dans le Finder, l'Explorateur ou votre gestionnaire de fichiers, ou sinon l'image de votre presse-papiers. Il attend qu'ils arrivent sur le serveur et place leurs chemins sur le serveur dans votre presse-papiers ; collez-les dans l'agent. Dans un terminal :
rdev laptop share send, ourdev laptop share send <files>. - Déposez des fichiers sur la fenêtre de l'application pour les envoyer de la même façon.
- Dans l'autre sens : les fichiers que votre agent place dans
~/Share/<laptop name>/outsur le serveur arrivent dans~/rdev-share/from-serversur votre ordinateur portable. Demandez-lui de « mettre le rapport dans out ». - Enregistrer ici les captures d'écran macOS fait enregistrer Shift-Command-3, 4 et 5 dans
~/rdev-share(rdev laptop share macos). Les applications de capture comme Shottr ou CleanShot peuvent aussi y enregistrer. - Les fichiers sont supprimés après 7 jours des deux côtés ; modifiez cela sous Conserver les fichiers (jours) dans l'application ou avec
rdev laptop share keep <days>(0 les conserve). Les fichiers d'un dossierkeepne sont jamais supprimés. - Les fichiers de plus de 500 Mo ne sont pas envoyés ; déplacez-les avec
scpoursync. Tout va directement à votre serveur et ne passe jamais par rdev.cloud. Désactivez le partage avec l'interrupteur de l'application ourdev laptop share off.
Avant la 1.2.0, c'était le dossier de captures d'écran : ~/rdev-shots est déplacé vers ~/rdev-share et ~/Shots vers ~/Share automatiquement, et ~/Shots continue de fonctionner comme lien.
Ordinateurs portables pris en charge
L'application pour ordinateur portable et rdev laptop fonctionnent sous macOS (Apple silicon et Intel), Linux (x64 et ARM64) et Windows 10 et 11 (x64 et ARM64) ; obtenez l'application sur la page de téléchargement. Sous Linux, vous pouvez l'installer avec une seule commande, qui prend le .deb sur Debian et Ubuntu, le .rpm sur Fedora et l'AppImage ailleurs, par exemple sur Arch et CachyOS : curl -fsSL https://rdev.cloud/install | sh -s -- app. L'AppImage est placée dans ~/.local/bin et apparaît dans votre menu d'applications ; l'application garde cette entrée pointée vers le fichier si vous le déplacez (1.4.4 ou version ultérieure). Si vous téléchargez vous-même le .deb, installez-le depuis /tmp (sudo apt install /tmp/rdev-linux-arm64.deb, ou -x64) ; depuis votre dossier personnel, apt fonctionne aussi mais signale que son utilisateur de sandbox ne peut pas lire le fichier. Sous Linux, rdev envoie *.dev.test vers votre serveur via systemd-resolved, que la plupart des distributions utilisent. S'il est désactivé ou masqué, comme sur certaines images de machines virtuelles, rdev laptop connect l'indique et montre comment l'activer : sudo systemctl unmask systemd-resolved && sudo systemctl enable --now systemd-resolved, puis sudo ln -sf /run/systemd/resolve/stub-resolv.conf /etc/resolv.conf, et reconnectez-vous. Quand NetworkManager garde son propre /etc/resolv.conf à côté d'un systemd-resolved en cours d'exécution (Tailscale signale alors qu'ils sont « wired together incorrectly »), les requêtes n'atteignent jamais la route de rdev ; rdev laptop connect et rdev laptop status le signalent (1.4.4 ou version ultérieure), et la même commande ln -sf règle le problème. rdev ajoute son certificat aux certificats de confiance du système sur Debian, Ubuntu, Fedora, openSUSE, Arch et CachyOS ; avant la 1.4.4, la connexion s'arrêtait là sur Arch et CachyOS.
Se connecter pas à pas
- Installez Tailscale sur votre ordinateur portable et connectez-vous avec le même compte Tailscale que celui de votre serveur. Sous Linux, vous pouvez passer cette étape : si Tailscale manque,
rdev laptop connectl'installe depuis le dépôt officiel de Tailscale et démarre la connexion, que vous terminez dans votre navigateur. - Installez rdev sur votre ordinateur portable et connectez-le. Exécutez ceci dans un terminal en tant que vous-même, et saisissez le mot de passe de votre ordinateur quand il est demandé ; il est nécessaire pour installer rdev, faire confiance au certificat et configurer la résolution de noms :
curl -fsSL https://rdev.cloud/install | sh -s -- laptop
Il installe la commande rdev et exécute rdev laptop connect, qui trouve votre serveur sur votre tailnet, ajoute une entrée rdev à votre configuration SSH, fait confiance au certificat de votre environnement, envoie *.dev.test vers votre serveur et commence à synchroniser votre dossier ~/Code avec ~/Code sur le serveur.
Vous n'avez rien d'autre à installer au préalable. Si l'outil de synchronisation manque, rdev installe une copie figée et vérifiée par somme de contrôle dans ~/.local/share/rdev/bin ; un outil que vous avez déjà est utilisé tel quel. Sous Linux, il installe aussi les outils de presse-papiers utilisés pour les captures d'écran (wl-clipboard, xclip) et certutil, qui place le certificat dans Chrome, avec votre gestionnaire de paquets, sous la même demande de mot de passe. Si vous avez donné un autre nom au serveur lors de l'installation, ajoutez --server <name> ; pour synchroniser un autre dossier, ajoutez --code-dir <folder>. Exécutez à nouveau rdev laptop connect chaque fois que vous voulez refaire la configuration.
Avant de demander votre mot de passe, rdev laptop connect vérifie le dossier qu'il va synchroniser. Il s'arrête et suggère --code-dir <dossier> si une autre session de synchronisation synchronise déjà ce dossier ou un dossier parent (le synchroniser aussi avec rdev copierait tout entre trois machines) ; lancez-le avec --force ou choisissez Synchroniser quand même dans l'application pour le synchroniser malgré tout. Un dossier de plus de 5 Go se connecte aussi, avec une note indiquant que la première synchronisation prend du temps (rdev 1.1.10 ou plus récent ; avant, il s'arrêtait).
Sur un Mac qui envoie déjà dev.test ailleurs, par exemple vers un autre serveur de développement, rdev met ce réglage de côté et le remet en place quand vous vous déconnectez ou désinstallez.
Sous Windows, la commande curl ci-dessus ne s'applique pas : installez l'application depuis la page de téléchargement et connectez-vous depuis celle-ci. À partir de l'application pour ordinateur portable 1.4.2, l'application installe aussi la commande rdev dans %USERPROFILE%\.local\share\rdev\bin et ajoute ce dossier à votre PATH ; ouvrez un nouveau terminal pour l'utiliser. La commande ne demande pas de droits d'administrateur et se met à jour avec l'application.
Si l'application continue d'afficher Check connection pendant que les fichiers se synchronisent, et que rdev laptop status indique *.dev.test resolves to …, not the server, consultez la page DNS de la console d'administration Tailscale. Une entrée de split DNS pour dev.test qui pointe vers une autre machine, comme un ancien serveur, l'emporte sous Windows sur le réglage de rdev. Supprimez-la, ou faites-la pointer vers votre serveur.
Vérifiez la connexion à tout moment avec rdev laptop status. rdev laptop disconnect arrête la synchronisation et supprime les paramètres ; vos fichiers restent des deux côtés.
Supprimer rdev de votre ordinateur portable
rdev laptop uninstall
Il se déconnecte, cesse de faire confiance au certificat de votre environnement, et supprime la commande rdev, ses paramètres et les outils qu'il a installés. Votre dossier synchronisé et ~/rdev-share restent. L'outil de synchronisation installé par rdev reste aussi tant que d'autres sessions de synchronisation l'utilisent. Il demande une fois le mot de passe de votre ordinateur et nécessite rdev 0.2.0-beta.21 ou une version ultérieure.
Votre ordinateur portable doit pouvoir se connecter au serveur : l'installateur copie les clés SSH qui pouvaient se connecter au serveur au moment de l'installation. Pour ajouter un autre ordinateur portable, ajoutez sa clé publique sur la page de votre serveur dans le panneau sous Clés SSH (une par ligne, donc plusieurs ordinateurs à la fois ; quand vous en ajoutez une, vous pouvez lui donner un nom comme Portable du travail, sinon le nom à la fin de la clé est affiché) ; le serveur la laisse entrer en quelques secondes. Cela nécessite rdev 0.2.0-beta.33 ou une version ultérieure ; avant cela, placez la clé dans /opt/rdev/home/.ssh/authorized_keys sur le serveur. Si rdev laptop connect indique qu'il ne peut pas se connecter, c'est ce qui manque.
Une fois connecté, ouvrez un terminal sur le serveur avec ssh rdev et lancez-y votre agent ; ouvrez vos sites dans le navigateur à l'adresse https://<folder>.dev.test. rdev open <projet> ouvre un terminal sur le serveur directement dans le dossier d'un projet, dans votre session persistante ; sans nom, il liste les projets (rdev 1.1.11 ou plus récent).
L'application Mac
Vous préférez cliquer plutôt que taper ? Téléchargez l'application rdev pour Mac (Apple silicon et Intel, signée et notarisée par Apple), faites-la glisser dans Applications et ouvrez-la. Elle indique si votre ordinateur portable est connecté, se connecte et se déconnecte d'un seul bouton et ouvre un terminal sur votre serveur. Elle effectue la même configuration que rdev laptop connect, vous avez donc besoin de Tailscale (étape 1) mais pas de la commande ; l'application installe l'outil de synchronisation elle-même. Avant de vous connecter, vous pouvez changer le dossier dans lequel vos projets se synchronisent (~/Code par défaut), la version de l'application de --code-dir.
À la première ouverture, l'application vous guide pas à pas et ses onglets ne s'ouvrent qu'une fois chaque étape réussie : connexion avec votre compte rdev, vérification que Tailscale est installé et connecté, choix du serveur dans votre compte, autorisation de cet ordinateur (l'application ajoute elle-même sa clé SSH au serveur, en en créant une s'il n'en a pas), choix avec Parcourir… du dossier où vos projets se synchronisent, puis connexion. Plus tard, Changer de serveur dans l'onglet Sites reconfigure l'ordinateur pour un autre serveur. Quand son serveur a disparu, injoignable ou absent de votre compte, l'application le signale et propose Reconfigurer. Dans les deux cas, vos fichiers restent en place. Quand la commande rdev est plus ancienne que l'application, About affiche Exécuter dans le Terminal, qui ouvre votre terminal avec la commande de mise à jour.
L'application comporte sept onglets :
- Sites : vos projets sous forme de liens
https://<name>.dev.test, un terminal sur le serveur et vos fichiers partagés. Chaque site a Open in Terminal, qui ouvre un terminal dans le dossier de ce projet sur le serveur. L'onglet Sites a aussi des boutons Mail et Dumps qui ouvrent vos pages d'e-mails et de dumps capturés. Il y a aussi un bouton Web terminal qui ouvre le terminal web. Il y a aussi un bouton Errors qui ouvre le suivi des erreurs. - Synchronisation : les mêmes paramètres que dans votre panneau (synchronisation activée ou non, projets sur cet ordinateur portable, exclusions). L'enregistrement les applique immédiatement sur cet ordinateur portable.
- Env : lisez et modifiez le
.envd'un projet sur le serveur. L'application passe par la connexion SSH, elle affiche donc les valeurs actuelles, et elles ne passent jamais par rdev.cloud. - Gotify : si vos notifications vont vers un serveur Gotify, l'application l'écoute et affiche chaque message comme une notification de bureau avec un son. Saisissez l'adresse du serveur et un jeton de client (Gotify Clients) ; ajoutez un jeton d'application (Gotify Apps) pour envoyer un message de test. Les jetons restent sur cet ordinateur portable.
- Intégrations : l'accès Git de votre serveur : sa clé, autant de comptes GitHub, GitLab, Bitbucket et autres que vous voulez (chacun avec sa propre clé SSH ou un jeton), les hôtes en attente de confiance et un test d'accès. Les jetons vont au serveur via SSH, jamais par rdev.cloud.
- Paramètres : l'application de terminal que Terminal sur le serveur ouvre (n'importe laquelle installée, comme Terminal, iTerm2 ou Warp ; conservée jusqu'à ce que vous la changiez), l'icône de la barre des menus (monochrome, qui suit une barre des menus claire ou sombre, ou l'icône colorée de l'application), la synchronisation des captures d'écran, et votre compte : choisissez Se connecter avec rdev.cloud, confirmez votre mot de passe dans le navigateur, vérifiez qu'il affiche le même code, et approuvez. Les applications connectées sont listées, et peuvent être déconnectées, sous Paramètres > Applications connectées dans votre panneau.
- À propos : les versions de l'application et de la commande
rdev, et la dernière application sur rdev.cloud.
Le terminal intégré
Terminal on the server ouvre le terminal intégré de rdev : une fenêtre à part que vous pouvez redimensionner, agrandir ou passer en plein écran, et qui se rouvre à sa dernière taille. Il se connecte avec ssh rdev et rejoint la session persistante de votre serveur : fermer la fenêtre ou perdre le réseau n'arrête jamais un agent ; si la connexion tombe, il se reconnecte tout seul et vous reprenez là où vous en étiez.
- Copier et coller : Cmd-C et Cmd-V sur macOS, Ctrl-Shift-C et Ctrl-Shift-V sur Linux et Windows. Le texte copié sur le serveur, par exemple dans vim, arrive dans le presse-papiers de votre portable. Avec les captures d'écran activées, coller une image l'envoie au serveur et colle son chemin, prêt pour votre agent.
- Shift-Entrée commence une nouvelle ligne dans l'invite de Claude Code.
- Rechercher avec Cmd-F (Ctrl-Shift-F sur Linux et Windows) ; changez la taille du texte avec Cmd et +, − ou 0 (Ctrl sur Linux et Windows).
- Les liens s'ouvrent dans votre navigateur, y compris les sites
https://<nom>.dev.test. Quand la fenêtre est en arrière-plan et que le terminal sonne, par exemple quand un agent a besoin de vous, vous recevez une notification. - Open in an external terminal ouvre la même session dans une app de terminal : le bouton à côté de Terminal on the server, le menu de l'icône de la barre des menus, ou Cmd-Shift-O (Ctrl-Shift-O) dans le terminal intégré. Pour faire d'une app de terminal celle par défaut, choisissez-la dans Settings. External terminal dans Settings choisit l'app utilisée ; au départ, c'est l'app de terminal choisie auparavant, sinon Terminal sur Mac.
L'application recherche une version plus récente au démarrage, toutes les six heures et quand vous ouvrez À propos. Quand il y en a une, une barre au-dessus des onglets l'indique : choisissez Mettre à jour, et l'application la télécharge, vérifie sa signature, l'installe et redémarre (sous Linux, le .deb et le .rpm demandent votre mot de passe ; sous Windows, le programme d'installation s'exécute seul). La mise à jour dans l'application nécessite la version 0.2.0-beta.34 ou ultérieure ; installez les versions plus anciennes à la main une fois. La commande rdev de votre portable se met à jour à part : relancez la commande d'installation, curl -fsSL https://rdev.cloud/install | sh -s -- laptop. Sous Windows, elle est fournie avec l'application et se met à jour avec elle. Quand la commande est plus ancienne que l'app, About affiche cette commande avec un bouton de copie.
Fermer la fenêtre garde rdev dans la barre des menus et le retire du Dock et de Cmd-Tab ; Quitter dans le menu de l'icône de la barre des menus, ou Cmd-Q, le quitte.
Sous Settings (application pour ordinateur portable 1.4.3 ou version ultérieure), Open at login démarre rdev en arrière-plan à l'ouverture de session, directement dans la barre des menus ou la zone de notification, et Keep running when the window is closed (activée par défaut) détermine si la fermeture de la fenêtre le garde là ou le quitte. Quand elle est activée, la synchronisation des fichiers et les notifications continuent de fonctionner fenêtre fermée. GNOME n'affiche les icônes de la zone de notification qu'avec l'extension AppIndicator (Ubuntu l'a) ; sans elle, une fenêtre fermée ne laisse aucune icône sur laquelle cliquer, rouvrez alors rdev depuis votre menu d'applications. L'application vous en avertit sous Settings (application pour ordinateur portable 1.4.4 ou version ultérieure). Le démarrage à l'ouverture de session ne demande pas de droits d'administrateur : rdev ajoute un élément de connexion pour votre utilisateur uniquement (un launch agent sur macOS, une entrée autostart sous Linux, une entrée Run dans le registre de votre utilisateur sous Windows).
L'application applique aussi les règles de synchronisation du panneau toutes les cinq minutes pendant son exécution.
Firefox conserve sa propre liste de certificats. Sous Linux, rdev ajoute son certificat à Chrome et à chaque profil Firefox qu'il trouve, y compris le Firefox snap que livre Ubuntu et celui de Flatpak (rdev 0.2.0-beta.34 ou ultérieur) ; redémarrez Firefox ensuite. Pour un profil Firefox créé plus tard, ou sous macOS et Windows, importez ~/.config/rdev/ca.pem sous Settings > Privacy & Security > Certificates.