Escribe al menos dos letras para buscar en todas las páginas de la documentación.

↑ ↓ para navegar ↵ para abrir esc para cerrar

Uso de rdev

Conexión de tu portátil

Tu portátil es el editor y el navegador. El código, los servicios y los agentes se quedan en tu servidor.

Tu propia tailnet

Tu portátil y tu servidor se comunican por una red privada de Tailscale que pertenece a tu cuenta de Tailscale. rdev nunca se une a ella. El instalador conecta tu servidor con una clave de tu cuenta, y la aplicación para portátil conecta tu portátil.

Sincronización de archivos

rdev mantiene los archivos de tu proyecto sincronizados entre tu portátil y tu servidor, en ambos sentidos. Las carpetas que no necesitan viajar, como node_modules, vendor y la salida de compilación, se ignoran desde el principio.

Tú eliges qué se sincroniza en tu panel, en Panel > tu servidor > Ajustes:

  • Sincronizar con los portátiles: desactívalo para trabajar totalmente en remoto. No se copia nada al portátil; tu editor abre los proyectos por SSH (ssh rdev, VS Code o Cursor Remote-SSH, PhpStorm Gateway). Los sitios y .dev.test siguen funcionando.
  • Proyectos en los portátiles: desmarca un proyecto para dejarlo solo en el servidor. Una copia que ya esté en tu portátil se deja como está, así que elimínala cuando ya no la necesites. Cuando un proyecto vuelve a sincronizarse más adelante, la copia antigua del portátil se mueve primero a ~/Code-rdev-old/ y baja la copia del servidor.
  • Nunca sincronizado: las exclusiones predeterminadas, cada una de las cuales puedes desactivar, más tus propios patrones con una sintaxis parecida a la de .gitignore.

Los portátiles aplican las nuevas reglas en unos minutos. Ejecuta rdev laptop sync para aplicarlas de inmediato.

Editores y el navegador

Usa el editor que ya conoces, como VS Code o PhpStorm, sobre los archivos sincronizados. Abre tus sitios en tu navegador habitual en https://<name>.dev.test; la aplicación para portátil configura la resolución de nombres y un certificado de confianza para estas direcciones.

Compartir archivos

Una terminal en tu servidor no puede pegar un archivo, así que rdev da a tu agente una carpeta compartida. Todo lo que haya en ~/rdev-share en tu portátil se copia a ~/Share/<laptop name> en el servidor en unos segundos, incluso con la sincronización de archivos desactivada; cada portátil tiene allí su propia carpeta, así que varios portátiles pueden compartir a la vez. Pide a tu agente que «mire la última captura» o que «abra el archivo que acabo de enviar» y abre el más reciente. Sirve cualquier tipo de archivo: imágenes, PDF, logs, exportaciones.

  • Send clipboard en la aplicación (también en el icono de su barra de menús o de la bandeja) envía los archivos que copiaste en Finder, el Explorador o tu gestor de archivos, o si no, la imagen de tu portapapeles. Espera a que lleguen al servidor y pone sus rutas en el servidor en tu portapapeles; pégalas en el agente. En una terminal: rdev laptop share send, o rdev laptop share send <files>.
  • Suelta archivos en la ventana de la aplicación para enviarlos de la misma forma.
  • En sentido contrario: los archivos que tu agente pone en ~/Share/<laptop name>/out en el servidor llegan a ~/rdev-share/from-server en tu portátil. Pídele que «ponga el informe en out».
  • Save macOS screenshots here hace que Shift-Comando-3, 4 y 5 guarden en ~/rdev-share (rdev laptop share macos). Aplicaciones de capturas como Shottr o CleanShot también pueden guardar allí.
  • Los archivos se eliminan a los 7 días en ambos lados; cámbialo en Keep files for (days) en la aplicación o con rdev laptop share keep <days> (0 los conserva). Los archivos de una carpeta keep nunca se eliminan.
  • Los archivos de más de 500 MB no se envían; muévelos con scp o rsync. Todo va directamente a tu servidor y nunca pasa por rdev.cloud. Desactiva el uso compartido con el interruptor de la aplicación o con rdev laptop share off.

Antes de la 1.2.0 esta era la carpeta de capturas: ~/rdev-shots se mueve a ~/rdev-share y ~/Shots a ~/Share por sí solas, y ~/Shots sigue funcionando como enlace.

Portátiles compatibles

La aplicación para portátil y rdev laptop funcionan en macOS (Apple silicon e Intel), Linux (x64 y ARM64) y Windows 10 y 11 (x64 y ARM64); consigue la aplicación en la página de descarga. En Linux puedes instalarla con un solo comando, que toma el .deb en Debian y Ubuntu, el .rpm en Fedora y el AppImage en el resto, por ejemplo en Arch y CachyOS: curl -fsSL https://rdev.cloud/install | sh -s -- app. El AppImage se guarda en ~/.local/bin y aparece en tu menú de aplicaciones; la app mantiene esa entrada apuntando al archivo si lo mueves (1.4.4 o posterior). Si descargas tú mismo el .deb, instálalo desde /tmp (sudo apt install /tmp/rdev-linux-arm64.deb, o -x64); desde tu carpeta personal apt también funciona, pero avisa de que su usuario de sandbox no puede leer el archivo. En Linux, rdev envía *.dev.test a tu servidor mediante systemd-resolved, que usan la mayoría de las distribuciones. Si está desactivado o enmascarado, como en algunas imágenes de máquinas virtuales, rdev laptop connect lo indica y muestra cómo activarlo: sudo systemctl unmask systemd-resolved && sudo systemctl enable --now systemd-resolved, luego sudo ln -sf /run/systemd/resolve/stub-resolv.conf /etc/resolv.conf, y conecta de nuevo. Cuando NetworkManager mantiene su propio /etc/resolv.conf junto a un systemd-resolved en ejecución (Tailscale informa entonces de que están «wired together incorrectly»), las consultas nunca llegan a la ruta de rdev; rdev laptop connect y rdev laptop status lo indican (1.4.4 o posterior), y el mismo comando ln -sf lo soluciona. rdev añade su certificado a los certificados de confianza del sistema en Debian, Ubuntu, Fedora, openSUSE, Arch y CachyOS; antes de la 1.4.4 la conexión se detenía ahí en Arch y CachyOS.

Conectar paso a paso

  1. Instala Tailscale en tu portátil e inicia sesión con la misma cuenta de Tailscale que usa tu servidor. En Linux puedes omitir esto: si falta Tailscale, rdev laptop connect lo instala desde el repositorio oficial de Tailscale e inicia el inicio de sesión, que terminas en tu navegador.
  2. Instala rdev en tu portátil y conéctalo. Ejecuta esto en una terminal como tu propio usuario, e introduce la contraseña de tu portátil cuando se te pida; hace falta para instalar rdev, para confiar en el certificado y para configurar la resolución de nombres:
curl -fsSL https://rdev.cloud/install | sh -s -- laptop

Instala el comando rdev y ejecuta rdev laptop connect, que encuentra tu servidor en tu tailnet, añade una entrada rdev a tu configuración de SSH, confía en el certificado de tu entorno, envía *.dev.test a tu servidor y empieza a sincronizar tu carpeta ~/Code con ~/Code en el servidor.

No instalas nada más antes. Si falta la herramienta de sincronización, rdev instala una copia fijada y verificada con suma de comprobación en ~/.local/share/rdev/bin; una que ya tengas se usa tal cual. En Linux también instala con tu gestor de paquetes, bajo la misma solicitud de contraseña, las herramientas del portapapeles que se usan para las capturas (wl-clipboard, xclip) y certutil, que pone el certificado en Chrome. Si diste otro nombre al servidor al instalar, añade --server <name>; para sincronizar otra carpeta, añade --code-dir <folder>. Ejecuta rdev laptop connect de nuevo cuando quieras rehacer la configuración.

Antes de pedir tu contraseña, rdev laptop connect revisa la carpeta que va a sincronizar. Se detiene y sugiere --code-dir <carpeta> si otra sesión de sincronización ya sincroniza esa carpeta o una que la contiene (sincronizarla también con rdev lo copiaría todo entre tres máquinas); ejecútalo con --force o elige Sincronizar igualmente en la app para sincronizarla de todos modos. Una carpeta de más de 5 GB también se conecta, con una nota de que la primera sincronización tarda (rdev 1.1.10 o posterior; antes se detenía).

En un Mac que ya envía dev.test a otro lugar, por ejemplo a otro servidor de desarrollo, rdev aparta ese ajuste y lo devuelve cuando te desconectas o desinstalas.

En Windows, el comando curl anterior no se aplica: instala la app desde la página de descarga y conéctate desde ella. A partir de la app para portátil 1.4.2, la app también instala el comando rdev en %USERPROFILE%\.local\share\rdev\bin y añade esa carpeta a tu PATH; abre un terminal nuevo para usarlo. No necesita permisos de administrador y se actualiza con la app.

Si la app sigue mostrando Check connection mientras se sincronizan los archivos y rdev laptop status dice *.dev.test resolves to …, not the server, mira la página DNS de la consola de administración de Tailscale. Una entrada de split DNS para dev.test que apunte a otra máquina, como un servidor antiguo, prevalece en Windows sobre el ajuste de rdev. Quítala o haz que apunte a tu servidor.

Comprueba la conexión en cualquier momento con rdev laptop status. rdev laptop disconnect detiene la sincronización y elimina los ajustes; tus archivos se quedan en ambos lados.

Quitar rdev de tu portátil

rdev laptop uninstall

Se desconecta, deja de confiar en el certificado de tu entorno, y elimina el comando rdev, sus ajustes y las herramientas que instaló. Tu carpeta sincronizada y ~/rdev-share se quedan. La herramienta de sincronización que instaló rdev también se queda mientras otras sesiones de sincronización lo sigan usando. Pide la contraseña de tu portátil una vez y requiere rdev 0.2.0-beta.21 o posterior.

Tu portátil debe poder iniciar sesión en el servidor: el instalador copia las claves SSH que podían iniciar sesión en el servidor cuando lo instalaste. Para añadir otro portátil, añade su clave pública en la página de tu servidor en el panel, en Claves SSH (una por línea, así que varios ordenadores a la vez; al añadir una, puedes darle un nombre como Portátil del trabajo, y si no, se muestra el nombre del final de la clave); el servidor lo deja entrar en unos segundos. Eso requiere rdev 0.2.0-beta.33 o posterior; antes de eso, pon la clave en /opt/rdev/home/.ssh/authorized_keys en el servidor. Si rdev laptop connect dice que no puede iniciar sesión, esto es lo que falta.

Una vez conectado, abre una terminal en el servidor con ssh rdev e inicia tu agente allí; abre tus sitios en el navegador en https://<folder>.dev.test. rdev open <proyecto> abre un terminal en el servidor directamente en la carpeta de un proyecto, en tu sesión persistente; sin nombre, lista los proyectos (rdev 1.1.11 o posterior).

La aplicación para Mac

¿Prefieres hacer clic a escribir? Descarga la aplicación de rdev para Mac (Apple silicon e Intel, firmada y notarizada por Apple), arrástrala a Aplicaciones y ábrela. Muestra si tu portátil está conectado, conecta y desconecta con un botón y abre una terminal en tu servidor. Hace la misma configuración que rdev laptop connect, así que necesitas Tailscale (paso 1) pero no el comando; la aplicación instala la herramienta de sincronización por sí misma. Antes de conectar puedes cambiar la carpeta en la que se sincronizan tus proyectos (~/Code por defecto), la versión de la aplicación de --code-dir.

La primera vez que la abres, la app te guía paso a paso y sus pestañas solo se abren cuando todos los pasos han funcionado: inicia sesión con tu cuenta de rdev, comprueba que Tailscale está instalado y con sesión iniciada, elige tu servidor de tu cuenta, deja entrar a este portátil (la app añade su clave SSH al servidor por ti y crea una si no tiene), elige con Examinar… la carpeta donde se sincronizan tus proyectos y conecta. Más adelante, Cambiar de servidor en la pestaña Sites vuelve a configurar el portátil para otro servidor. Cuando su servidor ya no está, no responde o ya no figura en tu cuenta, la app lo indica y ofrece Configurar de nuevo. En ambos casos tus archivos se quedan donde están. Si el comando rdev es más antiguo que la app, About muestra Ejecutar en Terminal, que abre tu terminal con el comando de actualización.

La aplicación tiene siete pestañas:

  • Sites: tus proyectos como enlaces https://<name>.dev.test, una terminal en el servidor y tus archivos compartidos. Cada sitio tiene Open in Terminal, que abre un terminal en la carpeta de ese proyecto en el servidor. La pestaña Sites también tiene botones Mail y Dumps que abren tus páginas de correo y volcados capturados. También tiene un botón Web terminal que abre el terminal web. También hay un botón Errors que abre el seguimiento de errores.
  • Sync: los mismos ajustes que en tu panel (sincronización activada o desactivada, proyectos en este portátil, exclusiones). Al guardar se aplican de inmediato en este portátil.
  • Env: lee y cambia el .env de un proyecto en el servidor. La aplicación funciona sobre la conexión SSH, así que muestra los valores actuales, y nunca pasan por rdev.cloud.
  • Gotify: si tus notificaciones van a un servidor Gotify, la aplicación lo escucha y muestra cada mensaje como una notificación de escritorio con sonido. Introduce la dirección del servidor y un token de cliente (Gotify Clients); añade un token de aplicación (Gotify Apps) para enviar un mensaje de prueba. Los tokens se quedan en este portátil.
  • Integrations: el acceso a Git de tu servidor: su clave, tantas cuentas de GitHub, GitLab, Bitbucket y otras como quieras (cada una con su propia clave SSH o un token), los hosts pendientes de confianza y una prueba de acceso. Los tokens van al servidor por SSH, nunca a través de rdev.cloud.
  • Settings: la aplicación de terminal que abre Terminal on the server (cualquiera instalada, como Terminal, iTerm2 o Warp; se conserva hasta que la cambies), el icono de la barra de menús (monocromo, que sigue una barra de menús clara u oscura, o el icono de colores de la aplicación), la sincronización de capturas y tu cuenta: elige Sign in with rdev.cloud, confirma tu contraseña en el navegador, comprueba que muestre el mismo código y aprueba. Las aplicaciones con sesión iniciada aparecen, y se pueden desconectar, en Ajustes > Aplicaciones conectadas de tu panel.
  • About: las versiones de la aplicación y del comando rdev, y la última aplicación en rdev.cloud.

El terminal integrado

Terminal on the server abre el terminal integrado de rdev: una ventana propia que puedes redimensionar, maximizar o poner a pantalla completa, y que vuelve a abrirse con su último tamaño. Inicia sesión con ssh rdev y se une a la sesión persistente de tu servidor, así que cerrar la ventana o perder la red nunca detiene a un agente; si la conexión se cae, se reconecta solo y vuelves a donde lo dejaste.

  • Copiar y pegar: Cmd-C y Cmd-V en macOS, Ctrl-Shift-C y Ctrl-Shift-V en Linux y Windows. El texto copiado en el servidor, por ejemplo en vim, llega al portapapeles de tu portátil. Con las capturas activadas, pegar una imagen la envía al servidor y pega su ruta, lista para tu agente.
  • Shift-Intro empieza una línea nueva en el prompt de Claude Code.
  • Busca con Cmd-F (Ctrl-Shift-F en Linux y Windows); cambia el tamaño del texto con Cmd y +, − o 0 (Ctrl en Linux y Windows).
  • Los enlaces se abren en tu navegador, incluidos los sitios https://<nombre>.dev.test. Si la ventana está en segundo plano y el terminal hace sonar la campana, por ejemplo cuando un agente te necesita, recibes una notificación de escritorio.
  • Open in an external terminal abre la misma sesión en una app de terminal: el botón junto a Terminal on the server, el menú del icono de la barra de menús o Cmd-Shift-O (Ctrl-Shift-O) en el terminal integrado. Para que una app de terminal sea la predeterminada, elígela en Settings. External terminal en Settings elige qué app usa; al principio es la app de terminal que elegiste antes o, en Mac, Terminal.

La aplicación busca una versión más reciente al arrancar, cada seis horas y cuando abres About. Cuando la hay, una barra sobre las pestañas lo indica: elige Update, y la aplicación la descarga, comprueba su firma, la instala y se reinicia (en Linux el .deb y el .rpm piden tu contraseña; en Windows el instalador se ejecuta solo). Actualizar desde la aplicación requiere la 0.2.0-beta.34 o posterior; instala a mano una vez las versiones anteriores. El comando rdev de tu portátil se actualiza aparte: vuelve a ejecutar el comando de instalación, curl -fsSL https://rdev.cloud/install | sh -s -- laptop. En Windows viene con la app y se actualiza con ella. Cuando el comando es más antiguo que la app, About muestra ese comando con un botón para copiarlo.

Cerrar la ventana mantiene rdev en la barra de menús y lo quita del Dock y de Cmd-Tab; Quit en el menú del icono de la barra de menús, o Cmd-Q, lo cierra.

En Settings (app para portátil 1.4.3 o posterior), Open at login inicia rdev en segundo plano cuando inicias sesión, directamente en la barra de menús o en la bandeja del sistema, y Keep running when the window is closed (activada por defecto) decide si cerrar la ventana lo mantiene allí o lo cierra. Con ella activada, la sincronización de archivos y las notificaciones siguen funcionando con la ventana cerrada. GNOME solo muestra los iconos de la bandeja con la extensión AppIndicator (Ubuntu la incluye); sin ella, al cerrar la ventana no queda ningún icono en el que hacer clic, así que vuelve a abrir rdev desde tu menú de aplicaciones. La app avisa de esto en Settings (app para portátil 1.4.4 o posterior). Abrir al iniciar sesión no necesita permisos de administrador: rdev añade un elemento de inicio solo para tu usuario (un launch agent en macOS, una entrada de autostart en Linux, una entrada Run en el registro de tu usuario en Windows).

La aplicación también aplica las reglas de sincronización del panel cada cinco minutos mientras se ejecuta.

Firefox mantiene su propia lista de certificados. En Linux, rdev añade su certificado a Chrome y a todos los perfiles de Firefox que encuentra, incluido el Firefox snap que trae Ubuntu y el de Flatpak (rdev 0.2.0-beta.34 o posterior); reinicia Firefox después. Para un perfil de Firefox creado más tarde, o en macOS y Windows, importa ~/.config/rdev/ca.pem en Settings > Privacy & Security > Certificates.