O rdev vem com um perfil de agente de IA pronto, para que os seus agentes saibam como o ambiente funciona desde o primeiro dia.
Agentes suportados
| Agente | Suporte |
|---|---|
| Claude Code | Completo |
| Codex | Completo |
| opencode, Qwen Code, GitHub Copilot CLI, Gemini CLI | Completo |
| Cursor CLI, Antigravity CLI | Padrão |
Outros agentes que leem o AGENTS.md e falam MCP |
Padrão, instalado por você |
Suporte completo significa que o instalador, o perfil, as configurações gerenciadas, as notificações, o status das sessões e as atualizações cobrem o agente. Suporte padrão significa que o agente recebe as regras compartilhadas e o acesso MCP, sem extras específicos do agente. A aba Agentes do painel mostra o nível ao lado de cada agente.
Instalando agentes
Abra o servidor em Servidores na barra lateral e depois em Agentes. O card Agentes de IA lista todos os agentes que o rdev conhece, se estão instalados e em qual versão, e o comando que os inicia (copie-o com o botão ao lado). Instalar adiciona um agente, e o menu ⋯ atualiza ou remove um. O Codex faz parte da imagem do ambiente e não pode ser removido. As alterações são executadas no servidor e levam de alguns segundos a um minuto; o card mostra o resultado quando termina.
Os agentes são por ambiente: em um plano Team, cada membro escolhe os agentes do próprio ambiente, e instalar um não altera o de mais ninguém. Isso exige o rdev 0.2.0-beta.36 ou posterior; até o servidor executá-lo, o card pede que você atualize.
Atualizar os agentes
Os agentes não se atualizam sozinhos no seu servidor, e você nunca vê dentro de um agente o aviso "atualização instalada, reinicie". Atualize-os pelo menu ⋯ ou com rdev agents update (um agente: rdev agents update claude). Quando a versão muda, o rdev reabre cada sessão ociosa desse agente na nova versão: na mesma janela de terminal, na mesma conversa, com o histórico. Uma sessão cujo agente está trabalhando ou esperando sua resposta nunca é interrompida; ela fica na versão antiga até você iniciá-la de novo. As sessões de Claude Code, Codex, opencode, Qwen Code, GitHub Copilot CLI e Gemini CLI são reabertas; as do Cursor CLI e do Antigravity CLI continuam na versão antiga até você reiniciá-las. Requer rdev 1.1.5 ou posterior.
Outros modelos: chaves de provedores e atalhos
Os agentes também podem rodar em modelos de outros provedores. Em Chaves de provedores de modelos, na mesma aba, Adicionar chave guarda uma chave de API da Anthropic, OpenAI, Google Gemini, DeepSeek, Kimi (Moonshot), GLM (Z.ai), MiniMax, Qwen (Alibaba), OpenRouter, Groq, xAI ou Mistral. Para o Ollama, você informa o endereço do seu servidor Ollama (http://… ou https://…) no lugar de uma chave. A chave é criptografada no seu navegador para este servidor: o painel nunca a vê, não consegue exibi-la de novo e só sabe quais provedores têm uma. Adicionar uma chave para um provedor que já tem uma a substitui.
Depois que uma chave é definida, atalhos prontos iniciam um agente nos modelos desse provedor em um projeto:
| Atalhos | Provedores |
|---|---|
claude-deepseek, claude-kimi, claude-glm, claude-minimax, claude-qwen |
Claude Code nos modelos DeepSeek, Kimi, GLM, MiniMax ou Qwen |
codex-deepseek, codex-openrouter, codex-groq, codex-xai, codex-ollama |
Codex nos modelos DeepSeek, OpenRouter, Groq, xAI ou Ollama |
qwen-<provider>, como qwen-openrouter |
Qwen Code nos modelos de outro provedor |
O card lista os atalhos que as suas chaves deixam prontos. O Claude Code com modelos que não sejam o Claude não é oficialmente suportado pela Anthropic: funciona para a maioria das tarefas, mas alguns recursos podem se comportar de forma diferente.
Regras compartilhadas
As regras que todo agente segue ficam em um só lugar, o AGENTS.md. O Codex, o Gemini CLI e o opencode o leem diretamente, e o Claude Code o inclui a partir do próprio CLAUDE.md. As partes específicas de cada agente, como as skills e os hooks do Claude Code, ficam por cima dessas regras compartilhadas.
Quanto do perfil você recebe depende do seu plano:
- Single: regras básicas.
- Pro: o perfil completo, com skills, agentes e roteamento de modelos.
- Team: o perfil completo mais as regras compartilhadas da equipe.
O perfil completo adiciona skills do Claude Code para Laravel, WordPress, depuração e deploy neste ambiente; um subagente frontend que faz o trabalho visual em um modelo mais rápido e mais barato enquanto a sessão principal fica com as partes difíceis (esse é o roteamento de modelos); e um subagente reviewer para uma revisão independente antes de uma alteração ser concluída. As regras da equipe são escritas na página Equipes. Se você passar para o Single, os arquivos do perfil completo são removidos, a menos que você os tenha alterado.
O guia de comandos do rdev
Cada plano instala uma skill rdev para cada agente de programação que você usa. É um guia curto que diz ao agente qual comando rdev ou ferramenta MCP do rdev resolve cada tarefa: adicionar e executar projetos, instalar versões de linguagem, PHP e Node, bancos de dados e serviços, manter workers e tarefas agendadas em execução, pré-visualizações, checkpoints, acesso ao Git, backups, deploys, rastreamento de erros, notificações e a licença. Os agentes o carregam sozinhos quando uma tarefa precisa dele, então basta pedir, por exemplo, "adicione um banco Postgres ao shop" ou "execute o worker de filas do blog".
Ele é instalado em ~/.claude/skills/rdev (Claude Code) e ~/.agents/skills/rdev (Codex, opencode, Qwen Code, GitHub Copilot CLI, Gemini CLI e Cursor), e em ~/.gemini/config/skills/rdev quando o Antigravity está instalado. O rdev mantém esses arquivos atualizados; coloque suas próprias skills em outras pastas.
Acesso MCP
Os agentes recebem acesso MCP aos seus sites e bancos de dados. Isso permite que um agente crie um site, adicione Redis, um banco de dados, busca ou armazenamento S3 a um projeto, instale uma extensão do PHP como mongodb quando o composer pedir, consulte um banco de dados ou leia um e-mail capturado por conta própria, em vez de pedir que você faça isso.
A partir do rdev 0.2.0-beta.34, os agentes também gerenciam os processos e tarefas agendadas de cada projeto: depois de escrever um job em fila, o agente configura sozinho o queue worker ou o scheduler do Laravel, reinicia um worker depois de alterar o código que ele executa e lê a saída de um processo. Ele lê o final do log do Laravel ou o último erro quando uma requisição falha, lista, cria e restaura checkpoints (abaixo), compartilha um site como preview quando você pede e informa se o backup noturno foi executado. O Claude Code pergunta a você antes de usar uma ferramenta pela primeira vez, como em qualquer outra ferramenta MCP.
Sua própria conta
Você conecta a sua própria conta da Anthropic ou da OpenAI, ou as chaves de provedores acima. O uso dos agentes é cobrado por esses provedores e não está incluído na sua assinatura do rdev. Nós nunca vemos os seus prompts nem o seu uso.
Agentes rodando o dia todo
Dê o prompt ao agente e deixe-o rodar no seu servidor; você fecha o laptop e aproveita o seu dia. Os agentes rodam no seu servidor, não no seu laptop, então uma tarefa que leva horas continua depois que você sai.
Cada login SSH no seu servidor abre a mesma sessão persistente, chamada main: o Terminal on the server do app do laptop, ssh rdev ou um app SSH no celular ou tablet. Você não a inicia sozinho (rdev 1.0.1 ou posterior).
Open in Terminal de um projeto no app do notebook e rdev open <projeto> abrem em vez disso a sessão persistente própria desse projeto, com o nome dele e iniciada na sua pasta. Assim cada projeto mantém suas próprias janelas e agentes, e dois dispositivos em projetos diferentes nunca trocam a visão um do outro (rdev 1.3.1 ou posterior).
- Inicie o agente nesse terminal e dê a tarefa a ele.
- Feche a tampa, feche o app ou deixe a conexão cair. O agente continua trabalhando no servidor. Para sair de propósito, pressione Ctrl-b e depois d.
- Volte de qualquer dispositivo: entre de novo e você está na mesma sessão, exatamente onde parou. Sessões de agentes no painel e suas notificações avisam quando o trabalho termina ou espera por você.
Algumas teclas ajudam: Ctrl-b c abre uma nova janela (para um segundo agente), Ctrl-b n e Ctrl-b p alternam entre janelas, e você pode rolar com o mouse ou o trackpad. Para desligar a sessão persistente, execute rdev session persist off no servidor (on a liga de novo; rdev 1.0.5 ou posterior); os terminais remotos do seu editor (VS Code, Cursor) e a sincronização de arquivos nunca a usam.
Quando uma sessão terminou, continue a mesma conversa com o comando do próprio agente, como claude --continue (ou claude --resume para escolher uma) e codex resume. As conversas ficam no seu servidor, na sua pasta pessoal, através de atualizações e reinicializações.
rdev host update reinicia o ambiente, o que interrompe todos os agentes e todas as sessões persistentes. Ele espera enquanto um agente trabalha ou aguarda você, e avisa isso; rdev host update --force atualiza mesmo assim.
Sessões de agentes no painel
Sessões de agentes no painel lista as sessões do Claude Code e do Codex nos seus servidores e o que cada uma está fazendo: Trabalhando, Aguardando você (um pedido de permissão ou uma pergunta), Concluído ou Parado por um erro. Ela é atualizada a cada poucos segundos e funciona em um celular, então você pode acompanhar uma tarefa longa de qualquer lugar. As sessões que aguardam você vêm primeiro.
Apenas o agente, a sessão, o nome da pasta do projeto e o estado chegam ao painel; nunca os seus prompts, as respostas do agente ou o seu código. As sessões são mantidas por uma semana. O Codex informa Trabalhando e Concluído; os pedidos de aprovação dele ainda não aparecem.
O menu ⋯ de uma sessão interrompe uma que esteja em execução: o servidor encerra o processo do agente em segundos (os arquivos que ele já alterou permanecem, e o checkpoint do início da sessão pode desfazê-los; isso exige o rdev 0.2.0-beta.36 ou posterior). Uma sessão que roda em um terminal persistente mostra um selo Persistente, e Fechar janela do terminal no menu dela interrompe o agente se ele ainda estiver trabalhando e fecha a janela do terminal no servidor, também depois que o agente terminou (rdev 1.0.1 ou posterior). Remover da lista oculta uma sessão, e Limpar concluídas remove de uma vez todas as sessões concluídas, com falha ou inativas; uma sessão que informar de novo volta. Abrir no terminal web abre essa janela de terminal no terminal web do seu servidor a partir de um dispositivo da sua tailnet (apenas nos seus próprios servidores, rdev 1.4.5 ou posterior); se a janela já não existir, abre-se a sua sessão persistente habitual.
Checkpoints: desfaça o que um agente fez
Quando um turno do agente começa em um projeto git, o rdev antes salva um checkpoint dos arquivos do projeto: arquivos rastreados e novos, não os ignorados. É um commit fora das suas branches, então o git status, o seu histórico e o seu stash continuam iguais. Cada projeto mantém os últimos 20 checkpoints; um turno que não alterou nada não adiciona nenhum.
Os checkpoints automáticos antes de cada turno vêm dos hooks do agente, então Claude Code, Codex, opencode, Qwen Code, GitHub Copilot CLI e Gemini CLI os recebem sozinhos. Cursor CLI e Antigravity CLI não têm esses hooks; recebem checkpoints quando iniciados pelo rdev, que também mostra a sessão no painel e avisa quando ela termina:
rdev agents run cursor
Para o Antigravity CLI, use rdev agents run antigravity.
Para desfazer, abra o seu servidor no painel e escolha um checkpoint em Desfazer e restaurar, ou faça isso no servidor. Liste os checkpoints do projeto:
rdev checkpoint list
Depois restaure um pelo id:
rdev checkpoint restore 1793603600
Restaurar devolve os arquivos ao estado em que estavam e exclui os arquivos adicionados desde então; o estado atual é salvo antes como um novo checkpoint (a menos que seja igual ao mais recente), então uma restauração também pode ser desfeita. rdev checkpoint create salva um manualmente. Os checkpoints exigem o rdev 0.2.0-beta.16 ou posterior.