Digite pelo menos duas letras para buscar em todas as páginas da documentação.

↑ ↓ para navegar ↵ para abrir esc para fechar

Usando o rdev

Conectando o seu laptop

O seu laptop é o editor e o navegador. O código, os serviços e os agentes ficam no seu servidor.

Sua própria tailnet

O seu laptop e o seu servidor conversam por uma rede privada Tailscale que pertence à sua conta do Tailscale. O rdev nunca entra nela. O instalador conecta o seu servidor com uma chave da sua conta, e o app para laptop conecta o seu laptop.

Sincronização de arquivos

O rdev mantém os arquivos dos seus projetos sincronizados entre o seu laptop e o seu servidor, nos dois sentidos. As pastas que não precisam viajar, como node_modules, vendor e arquivos de build, são ignoradas desde o início.

Você escolhe o que é sincronizado no seu painel, em Painel > seu servidor > Configurações:

  • Sincronizar com os laptops: desative para trabalhar totalmente remoto. Nada é copiado para o laptop; o seu editor abre os projetos por SSH (ssh rdev, Remote-SSH do VS Code ou do Cursor, PhpStorm Gateway). Os sites e o .dev.test continuam funcionando.
  • Projetos nos laptops: desmarque um projeto para mantê-lo somente no servidor. Uma cópia que já esteja no seu laptop é deixada como está, então exclua-a quando não precisar mais dela. Quando um projeto voltar a ser sincronizado depois, a cópia mais antiga do laptop é movida antes para ~/Code-rdev-old/ e a cópia do servidor é baixada.
  • Nunca sincronizado: as exclusões padrão, cada uma das quais você pode desativar, mais os seus próprios padrões em uma sintaxe parecida com a do .gitignore.

Os laptops aplicam as novas regras em alguns minutos. Execute rdev laptop sync para aplicá-las na hora.

Editores e o navegador

Use o editor que você já conhece, como o VS Code ou o PhpStorm, nos arquivos sincronizados. Abra os seus sites no seu navegador de sempre em https://<name>.dev.test; o app para laptop configura a resolução de nomes e um certificado confiável para esses endereços.

Compartilhamento de arquivos

Um terminal no seu servidor não consegue colar um arquivo, então o rdev dá ao seu agente uma pasta compartilhada. Tudo que estiver em ~/rdev-share no seu laptop é copiado para ~/Share/<laptop name> no servidor em segundos, mesmo com a sincronização de arquivos desativada; cada laptop tem a própria pasta lá, então vários laptops podem compartilhar ao mesmo tempo. Peça ao seu agente para "olhar a última captura de tela" ou "abrir o arquivo que acabei de enviar" e ele abre o mais recente. Qualquer tipo de arquivo funciona: imagens, PDFs, logs, exportações.

  • Enviar área de transferência no app (também no ícone da barra de menus ou da bandeja) envia os arquivos que você copiou no Finder, no Explorer ou no seu gerenciador de arquivos, ou então a imagem da sua área de transferência. Ele espera até chegarem ao servidor e coloca os caminhos deles no servidor na sua área de transferência; cole-os no agente. Em um terminal: rdev laptop share send, ou rdev laptop share send <files>.
  • Solte arquivos na janela do app para enviá-los do mesmo jeito.
  • No sentido contrário: os arquivos que o seu agente coloca em ~/Share/<laptop name>/out no servidor chegam em ~/rdev-share/from-server no seu laptop. Peça a ele para "colocar o relatório em out".
  • Salvar capturas de tela do macOS aqui faz com que Shift-Command-3, 4 e 5 salvem em ~/rdev-share (rdev laptop share macos). Apps de captura como o Shottr ou o CleanShot também podem salvar lá.
  • Os arquivos são excluídos após 7 dias nos dois lados; mude isso em Manter arquivos por (dias) no app ou com rdev laptop share keep <days> (0 os mantém). Arquivos em uma pasta keep nunca são excluídos.
  • Arquivos acima de 500 MB não são enviados; mova-os com scp ou rsync. Tudo vai direto para o seu servidor e nunca passa pelo rdev.cloud. Desative o compartilhamento com o interruptor no app ou com rdev laptop share off.

Antes da 1.2.0 esta era a pasta de capturas de tela: ~/rdev-shots passa para ~/rdev-share e ~/Shots para ~/Share sozinhas, e ~/Shots continua funcionando como link.

Laptops suportados

O app para laptop e o rdev laptop rodam no macOS (Apple silicon e Intel), no Linux (x64 e ARM64) e no Windows 10 e 11 (x64 e ARM64); baixe o app na página de download. No Linux você pode instalá-lo com um único comando, que usa o .deb no Debian e no Ubuntu, o .rpm no Fedora e o AppImage nos demais, por exemplo no Arch e no CachyOS: curl -fsSL https://rdev.cloud/install | sh -s -- app. O AppImage vai para ~/.local/bin e aparece no seu menu de aplicativos; o app mantém essa entrada apontando para o arquivo se você o mover (1.4.4 ou posterior). Se você baixar o .deb por conta própria, instale-o a partir de /tmp (sudo apt install /tmp/rdev-linux-arm64.deb, ou -x64); a partir da sua pasta pessoal o apt também funciona, mas avisa que o usuário do sandbox dele não consegue ler o arquivo. No Linux, o rdev envia *.dev.test para o seu servidor pelo systemd-resolved, que a maioria das distribuições usa. Se ele estiver desativado ou mascarado, como em algumas imagens de máquinas virtuais, o rdev laptop connect avisa e mostra como ativá-lo: sudo systemctl unmask systemd-resolved && sudo systemctl enable --now systemd-resolved, depois sudo ln -sf /run/systemd/resolve/stub-resolv.conf /etc/resolv.conf, e conecte de novo. Quando o NetworkManager mantém um /etc/resolv.conf próprio ao lado de um systemd-resolved em execução (o Tailscale então relata que eles estão "wired together incorrectly"), as consultas nunca chegam à rota do rdev; o rdev laptop connect e o rdev laptop status avisam isso (1.4.4 ou posterior), e o mesmo comando ln -sf resolve. O rdev adiciona seu certificado aos certificados confiáveis do sistema no Debian, Ubuntu, Fedora, openSUSE, Arch e CachyOS; antes da 1.4.4, a conexão parava aí no Arch e no CachyOS.

Conecte passo a passo

  1. Instale o Tailscale no seu laptop e entre com a mesma conta do Tailscale que o seu servidor usa. No Linux você pode pular isto: se o Tailscale estiver faltando, o rdev laptop connect o instala a partir do repositório oficial do Tailscale e inicia o login, que você conclui no navegador.
  2. Instale o rdev no seu laptop e conecte-o. Execute isto em um terminal como você mesmo e digite a senha do seu laptop quando solicitado; ela é necessária para instalar o rdev, para confiar no certificado e para configurar a resolução de nomes:
curl -fsSL https://rdev.cloud/install | sh -s -- laptop

Ele instala o comando rdev e executa o rdev laptop connect, que encontra o seu servidor na sua tailnet, adiciona uma entrada rdev à sua configuração de SSH, confia no certificado do seu ambiente, envia *.dev.test para o seu servidor e começa a sincronizar a sua pasta ~/Code com o ~/Code do servidor.

Você não precisa instalar mais nada antes. Se a ferramenta de sincronização estiver faltando, o rdev instala uma cópia fixada e verificada por checksum em ~/.local/share/rdev/bin; uma que você já tenha é usada como está. No Linux ele também instala as ferramentas de área de transferência usadas nas capturas de tela (wl-clipboard, xclip) e o certutil, que coloca o certificado no Chrome, com o seu gerenciador de pacotes, no mesmo pedido de senha. Se você deu outro nome ao servidor na instalação, adicione --server <name>; para sincronizar outra pasta, adicione --code-dir <folder>. Execute o rdev laptop connect de novo sempre que quiser refazer a configuração.

Antes de pedir sua senha, rdev laptop connect verifica a pasta que vai sincronizar. Ele para e sugere --code-dir <pasta> quando outra sessão de sincronização já sincroniza essa pasta ou uma que a contém (sincronizá-la também com o rdev copiaria tudo entre três máquinas); rode com --force ou escolha Sincronizar mesmo assim no app para sincronizar mesmo assim. Uma pasta com mais de 5 GB também conecta, com um aviso de que a primeira sincronização demora (rdev 1.1.10 ou posterior; antes, parava).

Em um Mac que já envia o dev.test para outro lugar, por exemplo para outro servidor de desenvolvimento, o rdev guarda essa configuração à parte e a restaura quando você desconecta ou desinstala.

No Windows, o comando curl acima não se aplica: instale o app pela página de download e conecte-se por ele. A partir do app para laptop 1.4.2, o app também instala o comando rdev em %USERPROFILE%\.local\share\rdev\bin e adiciona essa pasta ao seu PATH; abra um novo terminal para usá-lo. Ele não precisa de direitos de administrador e é atualizado junto com o app.

Se o app continua mostrando Check connection enquanto os arquivos sincronizam e o rdev laptop status diz *.dev.test resolves to …, not the server, veja a página DNS do console de administração do Tailscale. Uma entrada de split DNS para dev.test que aponta para outra máquina, como um servidor antigo, tem prioridade no Windows sobre a configuração do rdev. Remova-a ou aponte-a para o seu servidor.

Verifique a conexão a qualquer momento com rdev laptop status. O rdev laptop disconnect interrompe a sincronização e remove as configurações; os seus arquivos permanecem nos dois lados.

Remova o rdev do seu laptop

rdev laptop uninstall

Ele desconecta, deixa de confiar no certificado do seu ambiente e remove o comando rdev, as configurações dele e as ferramentas que ele instalou. A sua pasta sincronizada e o ~/rdev-share permanecem. A ferramenta de sincronização que o rdev instalou também permanece enquanto outras sessões de sincronização ainda o usarem. Ele pede a senha do seu laptop uma vez e exige o rdev 0.2.0-beta.21 ou posterior.

O seu laptop precisa conseguir entrar no servidor: o instalador copia as chaves SSH que podiam entrar no servidor quando você o instalou. Para adicionar outro laptop, adicione a chave pública dele na página do seu servidor no painel, em Chaves SSH (uma por linha, então vários computadores de uma vez; ao adicionar uma, você pode dar um nome a ela, como Laptop do trabalho, senão é exibido o nome no final da chave); o servidor o deixa entrar em segundos. Isso exige o rdev 0.2.0-beta.33 ou posterior; antes disso, coloque a chave em /opt/rdev/home/.ssh/authorized_keys no servidor. Se o rdev laptop connect disser que não consegue entrar, é isto que está faltando.

Depois de conectar, abra um terminal no servidor com ssh rdev e inicie o seu agente lá; abra os seus sites no navegador em https://<folder>.dev.test. rdev open <projeto> abre um terminal no servidor direto na pasta de um projeto, na sua sessão persistente; sem nome, lista os projetos (rdev 1.1.11 ou posterior).

O app para Mac

Prefere clicar a digitar? Baixe o app rdev para Mac (Apple silicon e Intel, assinado e notarizado pela Apple), arraste-o para Aplicativos e abra-o. Ele mostra se o seu laptop está conectado, conecta e desconecta com um único botão e abre um terminal no seu servidor. Ele faz a mesma configuração do rdev laptop connect, então você precisa do Tailscale (passo 1), mas não do comando; o app instala a ferramenta de sincronização sozinho. Antes de conectar, você pode alterar a pasta para a qual os seus projetos são sincronizados (~/Code por padrão), a versão do app do --code-dir.

Na primeira vez que você abre o app, ele guia a configuração passo a passo e as abas só abrem quando todos os passos funcionam: entre com sua conta rdev, confira se o Tailscale está instalado e conectado, escolha seu servidor na conta, libere este laptop (o app adiciona a chave SSH dele ao servidor por você e cria uma se não houver), escolha com Procurar… a pasta onde seus projetos sincronizam e conecte. Depois, Trocar de servidor na aba Sites configura o laptop de novo para outro servidor. Quando o servidor do laptop some, fica inacessível ou sai da sua conta, o app avisa e oferece Configurar de novo. Nos dois casos seus arquivos ficam onde estão. Quando o comando rdev é mais antigo que o app, About mostra Executar no Terminal, que abre o terminal com o comando de atualização.

O app tem sete abas:

  • Sites: os seus projetos como links https://<name>.dev.test, um terminal no servidor e os seus arquivos compartilhados. Cada site tem Open in Terminal, que abre um terminal na pasta desse projeto no servidor. A aba Sites também tem botões Mail e Dumps que abrem as páginas de e-mails e dumps capturados. Também há um botão Web terminal que abre o terminal web. Também há um botão Errors que abre o rastreamento de erros.
  • Sincronização: as mesmas configurações do seu painel (sincronização ativada ou desativada, projetos neste laptop, exclusões). Salvar as aplica neste laptop na hora.
  • Env: leia e altere o .env de um projeto no servidor. O app trabalha pela conexão SSH, então mostra os valores atuais, e eles nunca passam pelo rdev.cloud.
  • Gotify: se as suas notificações vão para um servidor Gotify, o app o escuta e mostra cada mensagem como uma notificação de desktop com som. Informe o endereço do servidor e um token de cliente (Clients do Gotify); adicione um token de aplicativo (Apps do Gotify) para enviar uma mensagem de teste. Os tokens ficam neste laptop.
  • Integrações: o Acesso ao Git do seu servidor: a chave dele, quantas contas GitHub, GitLab, Bitbucket e outras você quiser (cada uma com a própria chave SSH ou um token), hosts aguardando confiança e um teste de acesso. Os tokens vão para o servidor por SSH, nunca pelo rdev.cloud.
  • Configurações: o app de terminal que Terminal no servidor abre (qualquer um instalado, como o Terminal, o iTerm2 ou o Warp; mantido até você mudar), o ícone da barra de menus (monocromático, que acompanha uma barra de menus clara ou escura, ou o ícone colorido do app), a sincronização de capturas de tela e a sua conta: escolha Entrar com o rdev.cloud, confirme a sua senha no navegador, confira se ele mostra o mesmo código e aprove. Os apps conectados são listados, e podem ser desconectados, em Configurações > Aplicativos conectados no seu painel.
  • Sobre: as versões do app e do comando rdev, e o app mais recente no rdev.cloud.

O terminal integrado

Terminal on the server abre o terminal integrado do rdev: uma janela própria que você pode redimensionar, maximizar ou deixar em tela cheia, e que reabre no último tamanho. Ele entra com ssh rdev e se junta à sessão persistente do seu servidor, então fechar a janela ou perder a rede nunca para um agente; se a conexão cair, ele reconecta sozinho e você volta de onde parou.

  • Copiar e colar: Cmd-C e Cmd-V no macOS, Ctrl-Shift-C e Ctrl-Shift-V no Linux e no Windows. Texto copiado no servidor, por exemplo no vim, vai para a área de transferência do seu notebook. Com as capturas de tela ligadas, colar uma imagem a envia ao servidor e cola o caminho dela, pronto para o seu agente.
  • Shift-Enter começa uma nova linha no prompt do Claude Code.
  • Pesquise com Cmd-F (Ctrl-Shift-F no Linux e no Windows); mude o tamanho do texto com Cmd e +, − ou 0 (Ctrl no Linux e no Windows).
  • Links abrem no seu navegador, incluindo sites https://<nome>.dev.test. Quando a janela está em segundo plano e o terminal toca o sino, por exemplo quando um agente precisa de você, você recebe uma notificação.
  • Open in an external terminal abre a mesma sessão num app de terminal: o botão ao lado de Terminal on the server, o menu do ícone da barra de menus ou Cmd-Shift-O (Ctrl-Shift-O) no terminal integrado. Para tornar um app de terminal o padrão, escolha-o em Settings. External terminal em Settings escolhe a app usada; no início é a app de terminal escolhida antes ou, no Mac, o Terminal.

O app verifica se há uma versão mais nova ao iniciar, a cada seis horas e quando você abre Sobre. Quando há uma, uma barra acima das abas avisa: escolha Atualizar, e o app a baixa, verifica a assinatura, instala e reinicia (no Linux, o .deb e o .rpm pedem a sua senha; no Windows, o instalador roda sozinho). Atualizar pelo app exige a versão 0.2.0-beta.34 ou posterior; instale as versões mais antigas por cima manualmente uma vez. O comando rdev do seu notebook é atualizado à parte: rode de novo o comando de instalação, curl -fsSL https://rdev.cloud/install | sh -s -- laptop. No Windows ele vem com o app e é atualizado junto com ele. Quando o comando é mais antigo que o app, About mostra esse comando com um botão de copiar.

Fechar a janela mantém o rdev na barra de menus e o tira do Dock e do Cmd-Tab; Sair no menu do ícone da barra de menus, ou Cmd-Q, o encerra.

Em Settings (app para laptop 1.4.3 ou posterior), Open at login inicia o rdev em segundo plano quando você entra na sua conta, direto na barra de menus ou na bandeja do sistema, e Keep running when the window is closed (ativada por padrão) decide se fechar a janela o mantém lá ou o encerra. Com ela ativada, a sincronização de arquivos e as notificações continuam funcionando com a janela fechada. O GNOME só mostra ícones da bandeja com a extensão AppIndicator (o Ubuntu a tem); sem ela, uma janela fechada não deixa nenhum ícone para clicar, então abra o rdev de novo pelo menu de aplicativos. O app avisa sobre isso em Settings (app para laptop 1.4.4 ou posterior). Abrir no login não exige direitos de administrador: o rdev adiciona um item de login apenas para o seu usuário (um launch agent no macOS, uma entrada de autostart no Linux, uma entrada Run no registro do seu usuário no Windows).

O app também aplica as regras de sincronização do painel a cada cinco minutos enquanto está rodando.

O Firefox mantém a própria lista de certificados. No Linux, o rdev adiciona o certificado dele ao Chrome e a todos os perfis do Firefox que encontrar, incluindo o Firefox snap que o Ubuntu fornece e o Flatpak (rdev 0.2.0-beta.34 ou posterior); reinicie o Firefox depois. Para um perfil do Firefox criado depois, ou no macOS e no Windows, importe ~/.config/rdev/ca.pem em Configurações > Privacidade e segurança > Certificados.