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

Agentes de IA

rdev viene con un perfil de agente de IA listo para usar, para que tus agentes sepan cómo funciona el entorno desde el primer día.

Agentes compatibles

Agente Compatibilidad
Claude Code Total
Codex Total
opencode, Qwen Code, GitHub Copilot CLI, Gemini CLI Total
Cursor CLI, Antigravity CLI Estándar
Otros agentes que leen AGENTS.md y hablan MCP Estándar, instalados por ti

Compatibilidad total significa que el instalador, el perfil, los ajustes gestionados, las notificaciones, el estado de las sesiones y las actualizaciones cubren al agente. Compatibilidad estándar significa que el agente recibe las reglas compartidas y el acceso MCP, sin extras específicos del agente. La pestaña Agentes del panel muestra el nivel junto a cada agente.

Instalar agentes

Abre el servidor desde Servidores en la barra lateral y luego Agentes. La tarjeta Agentes de IA lista todos los agentes que rdev conoce, si están instalados y con qué versión, y el comando que lo inicia (cópialo con el botón junto a él). Instalar añade un agente, y el menú ⋯ actualiza o quita uno. Codex forma parte de la imagen del entorno y no se puede quitar. Los cambios se ejecutan en el servidor y tardan de unos segundos a un minuto; la tarjeta muestra el resultado cuando termina.

Los agentes son por entorno: en un plan Team cada miembro elige los agentes de su propio entorno, e instalar uno no cambia el de nadie más. Esto requiere rdev 0.2.0-beta.36 o posterior; hasta que el servidor lo ejecute, la tarjeta te pide que actualices.

Actualizar los agentes

Los agentes no se actualizan solos en tu servidor y nunca verás dentro de un agente el aviso «actualización instalada, reinicia». Actualízalos desde el menú ⋯ o con rdev agents update (un solo agente: rdev agents update claude). Cuando cambia la versión, rdev vuelve a abrir cada sesión inactiva de ese agente con la nueva versión: en la misma ventana de terminal, en la misma conversación y con su historial. Una sesión cuyo agente está trabajando o esperando tu respuesta nunca se interrumpe; conserva la versión anterior hasta que la vuelvas a iniciar. Se vuelven a abrir las sesiones de Claude Code, Codex, opencode, Qwen Code, GitHub Copilot CLI y Gemini CLI; las de Cursor CLI y Antigravity CLI siguen con la versión anterior hasta que las reinicies. Requiere rdev 1.1.5 o posterior.

Otros modelos: claves de proveedores y atajos

Los agentes también pueden funcionar con modelos de otros proveedores. En Claves de proveedores de modelos, en la misma pestaña, Añadir clave guarda una clave de API de Anthropic, OpenAI, Google Gemini, DeepSeek, Kimi (Moonshot), GLM (Z.ai), MiniMax, Qwen (Alibaba), OpenRouter, Groq, xAI o Mistral. Para Ollama introduces la dirección de tu servidor Ollama (http://… o https://…) en lugar de una clave. La clave se cifra en tu navegador para este servidor: el panel nunca la ve, no puede mostrarla de nuevo y solo sabe qué proveedores tienen una. Añadir una clave para un proveedor que ya tiene una la sustituye.

Una vez definida una clave, unos atajos ya preparados inician un agente con los modelos de ese proveedor en un proyecto:

Atajos Proveedores
claude-deepseek, claude-kimi, claude-glm, claude-minimax, claude-qwen Claude Code con modelos de DeepSeek, Kimi, GLM, MiniMax o Qwen
codex-deepseek, codex-openrouter, codex-groq, codex-xai, codex-ollama Codex con modelos de DeepSeek, OpenRouter, Groq, xAI u Ollama
qwen-<provider>, como qwen-openrouter Qwen Code con los modelos de otro proveedor

La tarjeta lista los atajos que tus claves dejan listos. Claude Code con modelos distintos de Claude no tiene compatibilidad oficial de Anthropic: funciona para la mayoría de las tareas, pero algunas funciones pueden comportarse de otra manera.

Reglas compartidas

Las reglas que sigue cada agente viven en un solo lugar, AGENTS.md. Codex, Gemini CLI y opencode lo leen directamente, y Claude Code lo incluye desde su propio CLAUDE.md. Las partes específicas de cada agente, como las skills y los hooks de Claude Code, se apoyan sobre estas reglas compartidas.

Cuánto del perfil recibes depende de tu plan:

  • Single: reglas base.
  • Pro: el perfil completo con skills, agentes y enrutamiento de modelos.
  • Team: el perfil completo más reglas compartidas del equipo.

El perfil completo añade skills de Claude Code para Laravel, WordPress, depuración y despliegue en este entorno; un subagente frontend que hace el trabajo visual con un modelo más rápido y barato mientras la sesión principal se queda con las partes difíciles (eso es el enrutamiento de modelos); y un subagente reviewer para una revisión independiente antes de terminar un cambio. Las reglas del equipo se escriben en la página Equipos. Si pasas a Single, los archivos del perfil completo se eliminan salvo que los hayas cambiado.

La guía de comandos de rdev

Cada plan instala una skill rdev para cada agente de programación que uses. Es una guía breve que le dice al agente qué comando rdev o qué herramienta MCP de rdev resuelve cada tarea: añadir y ejecutar proyectos, instalar versiones de lenguajes, PHP y Node, bases de datos y servicios, mantener en marcha workers y tareas programadas, vistas previas, checkpoints, acceso a Git, copias de seguridad, despliegues, seguimiento de errores, notificaciones y la licencia. Los agentes la cargan por sí solos cuando una tarea la necesita, así que basta con pedir, por ejemplo, "añade una base de datos Postgres a shop" o "ejecuta el worker de colas de blog".

Se instala en ~/.claude/skills/rdev (Claude Code) y ~/.agents/skills/rdev (Codex, opencode, Qwen Code, GitHub Copilot CLI, Gemini CLI y Cursor), y en ~/.gemini/config/skills/rdev cuando Antigravity está instalado. rdev mantiene estos archivos actualizados; pon tus propias skills en otras carpetas.

Acceso MCP

Los agentes reciben acceso MCP a tus sitios y bases de datos. Eso permite que un agente cree un sitio, añada Redis, una base de datos, búsqueda o almacenamiento S3 a un proyecto, instale una extensión de PHP como mongodb cuando composer la pide, consulte una base de datos o lea el correo capturado por sí solo, en lugar de pedirte que lo hagas tú.

Desde rdev 0.2.0-beta.34 los agentes también gestionan los procesos y tareas programadas de cada proyecto: tras escribir un trabajo en cola, un agente configura por sí mismo el worker de colas o el scheduler de Laravel, reinicia un worker tras cambiar el código que ejecuta y lee la salida de un proceso. Lee el final del registro de Laravel o su último error cuando falla una solicitud, lista, crea y restaura checkpoints (más abajo), comparte un sitio como vista previa cuando se lo pides y te dice si se ejecutó la copia de seguridad nocturna. Claude Code te pregunta antes de usar una herramienta por primera vez, como con cualquier otra herramienta MCP.

Tu propia cuenta

Conectas tu propia cuenta de Anthropic o de OpenAI, o las claves de proveedores anteriores. El uso de los agentes lo facturan esos proveedores y no está incluido en tu suscripción de rdev. Nunca vemos tus prompts ni tu uso.

Agentes funcionando las 24 horas

Dale el prompt al agente y déjalo trabajar en tu servidor; tú cierras el portátil y disfrutas de tu día. Los agentes se ejecutan en tu servidor, no en tu portátil, así que una tarea que dura horas sigue adelante cuando te vas.

Cada inicio de sesión SSH en tu servidor abre la misma sesión persistente, llamada main: el Terminal on the server de la aplicación del portátil, ssh rdev o una app SSH en el teléfono o la tableta. No la inicias tú mismo (rdev 1.0.1 o posterior).

Open in Terminal de un proyecto en la app del portátil y rdev open <proyecto> abren en cambio la sesión persistente propia de ese proyecto, con su nombre y iniciada en su carpeta. Así cada proyecto conserva sus propias ventanas y agentes, y dos dispositivos en proyectos distintos nunca cambian la vista del otro (rdev 1.3.1 o posterior).

  1. Inicia el agente en ese terminal y dale la tarea.
  2. Cierra la tapa, cierra la aplicación o deja que se corte la conexión. El agente sigue trabajando en el servidor. Para salir a propósito, pulsa Ctrl-b y luego d.
  3. Vuelve desde cualquier dispositivo: inicia sesión de nuevo y estarás en la misma sesión, donde la dejaste. Sesiones de agentes en el panel y tus notificaciones te avisan cuando el trabajo termina o te está esperando.

Algunas teclas ayudan: Ctrl-b c abre una ventana nueva (para un segundo agente), Ctrl-b n y Ctrl-b p se mueven entre ventanas, y puedes desplazarte con el ratón o el trackpad. Para desactivar la sesión persistente, ejecuta rdev session persist off en el servidor (on la vuelve a activar; rdev 1.0.5 o posterior); los terminales remotos de tu editor (VS Code, Cursor) y la sincronización de archivos nunca la usan.

Cuando una sesión ha terminado, continúa la misma conversación con el comando propio del agente, como claude --continue (o claude --resume para elegir una) y codex resume. Las conversaciones permanecen en tu servidor, en tu carpeta personal, a través de actualizaciones y reinicios.

rdev host update reinicia el entorno, lo que detiene todos los agentes y todas las sesiones persistentes. Espera mientras un agente trabaja o te está esperando, y te lo dice; rdev host update --force actualiza de todos modos.

Sesiones de agentes en el panel

Sesiones de agentes en el panel lista las sesiones de Claude Code y Codex en tus servidores y lo que está haciendo cada una: Trabajando, Esperándote (una solicitud de permiso o una pregunta), Terminado o Detenido por un error. Se actualiza cada pocos segundos y funciona en un teléfono, así que puedes consultar una tarea larga desde cualquier lugar. Las sesiones que te esperan van primero.

Al panel solo llegan el agente, la sesión, el nombre de la carpeta del proyecto y el estado; nunca tus prompts, las respuestas del agente ni tu código. Las sesiones se conservan durante una semana. Codex informa de Trabajando y Terminado; sus solicitudes de aprobación todavía no se muestran.

El menú ⋯ de una sesión detiene una que esté en ejecución: el servidor termina el proceso del agente en unos segundos (los archivos que ya cambió se quedan, y el checkpoint del inicio de la sesión puede deshacerlos; esto requiere rdev 0.2.0-beta.36 o posterior). Una sesión que se ejecuta en un terminal persistente muestra una insignia Persistente, y Cerrar ventana de terminal en su menú detiene al agente si aún trabaja y cierra su ventana de terminal en el servidor, también cuando el agente ya terminó (rdev 1.0.1 o posterior). Quitar de la lista oculta una sesión, y Borrar las terminadas quita de una vez todas las sesiones terminadas, fallidas o inactivas; una sesión que vuelve a informar regresa. Abrir en el terminal web abre esa ventana de terminal en el terminal web de tu servidor desde un dispositivo de tu tailnet (solo en tus propios servidores, rdev 1.4.5 o posterior); si la ventana ya no existe, se abre tu sesión persistente habitual.

Checkpoints: deshacer lo que hizo un agente

Cuando empieza un turno de un agente en un proyecto git, rdev guarda primero un checkpoint de los archivos del proyecto: archivos rastreados y nuevos, no los ignorados. Es un commit fuera de tus ramas, así que git status, tu historial y tu stash se ven igual. Cada proyecto conserva sus últimos 20 checkpoints; un turno que no cambió nada no añade ninguno.

Los puntos de control automáticos antes de cada turno vienen de los hooks del agente, así que Claude Code, Codex, opencode, Qwen Code, GitHub Copilot CLI y Gemini CLI los tienen por sí solos. Cursor CLI y Antigravity CLI no tienen esos hooks; tienen puntos de control cuando los inicias a través de rdev, que además muestra la sesión en el panel y te avisa cuando termina:

rdev agents run cursor

Para Antigravity CLI usa rdev agents run antigravity.

Para deshacer, abre tu servidor en el panel y elige un checkpoint en Deshacer y restaurar, o hazlo en el servidor. Lista los checkpoints del proyecto:

rdev checkpoint list

Luego restaura uno por su ID:

rdev checkpoint restore 1793603600

Restaurar devuelve los archivos a como estaban y elimina los archivos añadidos desde entonces; el estado actual se guarda antes como un checkpoint nuevo (salvo que coincida con el más reciente), así que una restauración también se puede deshacer. rdev checkpoint create guarda uno a mano. Los checkpoints requieren rdev 0.2.0-beta.16 o posterior.