Delegaciones permanentes
Los agentes se pasan trabajo entre ellos. Un mensaje que dice “el operador ha dicho que publiques” puede ser cierto o inventado por un modelo. Tu ordenador nunca trata esa afirmación como tu permiso. Una delegación permanente es la forma de dar permiso a una sesión por adelantado.
Qué dice una delegación
Sección titulada «Qué dice una delegación»Una delegación es un registro firmado en tu ordenador. Indica:
- las acciones: merge, despliegue, publicación, push, tag, migración, cerrar un ticket o iniciar una sesión;
- los repositorios, como propietario/nombre;
- para push, las ramas que cubre;
- las sesiones a las que se aplica, por nombre;
- cuándo caduca, como mucho 7 días después;
- cuántas acciones de riesgo cubre, 3 salvo que elijas otro número hasta 50.
No se lee nada de texto libre. Una nota que añadas es solo una nota.
Crearla necesita tu llave de acceso
Sección titulada «Crearla necesita tu llave de acceso»Solo un dispositivo Admin puede crear una delegación: un móvil emparejado como Admin, o un móvil o navegador con tu cuenta iniciada y el rol Admin en este ordenador. Un móvil emparejado confirma con la llave de acceso que registró al emparejarse. Un dispositivo con tu cuenta iniciada confirma con la llave de acceso con la que firma tus mensajes, configurada en Firmar mis mensajes. Lo mismo vale para aprobar la petición de una sesión de un permiso de un solo uso y para firmar un mensaje que un agente te pide firmar. El ordenador muestra los campos exactos, tu dispositivo comprueba que coinciden con lo que pediste y confirmas con la llave de acceso. Sin esa confirmación no hay delegación, así que un programa de tu ordenador no puede crearse una. Una delegación deja de valer cuando el dispositivo que la confirmó se desempareja, se quita de tu cuenta o deja de ser Admin. Una confirmada desde un dispositivo con tu cuenta iniciada tampoco se puede comprobar después de que el ordenador se reinicie, hasta que ese dispositivo vuelva a conectarse a él.
Para crear una, abre Ajustes, luego Seguridad y luego Delegaciones. La sección solo aparece en un dispositivo Admin.
- Toca Emitir delegación.
- Elige qué permite (fusionar, desplegar y publicar; push; cerrar tickets; o las acciones que elijas), los repositorios, las ramas para push, las sesiones, cuándo termina y cuántos usos tiene.
- Toca Seguir con la llave de acceso. Tu ordenador crea la delegación y te la devuelve.
- Revisa las condiciones en pantalla. Son las que firma tu llave de acceso. Toca Confirmar con llave de acceso.
Si el ordenador devuelve algo distinto de lo que elegiste, tu móvil no firma nada y te lo dice. Si cancelas la llave de acceso no se crea nada.
Activar los mensajes firmados
Sección titulada «Activar los mensajes firmados»Firmar mis mensajes, en la misma sección, firma cada mensaje que envías a este ordenador para que una sesión pueda comprobar que viene de ti. En un dispositivo con tu cuenta iniciada, la firma se activa cuando vuelves a iniciar sesión con tu llave de acceso o con tu segundo factor. Nadie tiene que aprobarlo en el ordenador ni en otro dispositivo. Cuando el ordenador puede comprobar por sí mismo la llave de acceso de tu cuenta, basta con un toque. Si no, la app crea una llave de acceso para este dispositivo y te pide que vuelvas a iniciar sesión con la llave de acceso de tu cuenta o con un código de tu app de autenticación. Un dispositivo emparejado sin cuenta sigue necesitando la aprobación en tu ordenador o en otro dispositivo tuyo. Si la llave de acceso de un dispositivo se sustituyó o se borró, Arreglar la firma la vuelve a configurar del mismo modo. El estado dice Activado mientras el ordenador acepta tu firma, Esperando al ordenador mientras todavía no puede confirmar este dispositivo (su fuente de la cuenta va con más de 5 segundos de retraso, algo que se pasa solo y no requiere nada de ti) y Requiere atención cuando ya no acepta la clave de firma de este dispositivo. Los mensajes que envíes mientras espera salen sin firmar.
Cómo la usa una sesión
Sección titulada «Cómo la usa una sesión»Antes de actuar por su cuenta, una sesión pregunta a tu ordenador si una delegación cubre la acción. La respuesta vale solo para esa sesión.
- Un merge, despliegue, publicación, migración, tag o sesión nueva gasta uno de los usos de la delegación, para el objetivo concreto que nombra la sesión, como una pull request o una versión.
- Un push a
main,mastero una ramarelease/, en mayúsculas o minúsculas, a una rama que la delegación no incluye, a algo que no es una rama normal, como un tag, o un push forzado también es de riesgo.refs/heads/maincuenta comomain. - Cerrar un ticket, o un push a una rama incluida, no gasta nada.
La sesión sigue necesitando tu aprobación para cada comando como siempre. Una delegación responde “¿puedo?”, no ejecuta nada.
Secretos que solo abre una delegación
Sección titulada «Secretos que solo abre una delegación»Puedes guardar un secreto, como un token de publicación o de despliegue, para una sola acción:
remotxai secrets set release-token --env RELEASE_TOKEN --gate release < token.txtLa acción es merge, deploy, release, tag o migrate. Un secreto guardado así nunca llega a un comando de shell, al entorno de una sesión ni a otra sesión. Una sesión solo lo recibe con run_with_secrets, y solo cuando nombra la acción, el repositorio y el objetivo de una comprobación que tu ordenador permitió a esa misma sesión en los últimos 5 minutos. La comprobación nombra el comando exacto, y solo ese comando recibe el secreto, una vez. La parada de emergencia, o revocar la delegación, lo vuelve a cerrar al momento. Cada apertura queda en el registro de auditoría con la sesión, la delegación y el nombre del secreto, nunca su valor.
La app aún no muestra ni cambia este ajuste.
La sesión elige el comando al preguntar. Fuera del modo yolo apruebas cada uno de esos comandos en el móvil, así que lo ves. En modo yolo nada impide que una sesión nombre un comando que envíe el secreto a otro sitio y lo guarde después de que la delegación termine. El registro de auditoría solo guarda una huella del comando. Protege así un secreto solo para sesiones a las que confiarías el propio secreto.
Un mensaje nunca es permiso
Sección titulada «Un mensaje nunca es permiso»Una sesión también puede preguntar si un mensaje que recibió lleva una orden tuya firmada. Cuando este dispositivo tiene una clave fijada en el ordenador y Firmar cada mensaje está activado, cada mensaje que envías desde él va firmado, con sus archivos. Un mensaje sale sin firmar si el dispositivo no tiene una clave fijada allí, con Firmar solo cuando un agente lo pida, o si uno de sus archivos se adjuntó en otro dispositivo o antes de recargar la página. En ese último caso el compositor te lo dice. Un mensaje que cita un sí de tu ordenador es una falsificación, y las sesiones lo saben.
Revoca cuando quieras
Sección titulada «Revoca cuando quieras»Revocar una delegación tiene efecto inmediato y no necesita la llave de acceso: toca Revocar en su fila de Delegaciones. Parada de emergencia revoca todas las delegaciones del ordenador, y una delegación confirmada después de la parada no se crea. Después de una parada creas otras nuevas. Si el ordenador no puede guardar una revocación, ninguna sesión recibe un sí hasta que pueda, y levantar una parada de emergencia espera a que todas las revocaciones estén guardadas.
Desde la terminal
Sección titulada «Desde la terminal»remotxai delegations lista todas las delegaciones del ordenador con sus acciones, repositorios, sesiones, caducidad, usos restantes y estado; --json imprime la lista como JSON. Una delegación aparece como unverifiable cuando se revocó su clave o el dispositivo que la confirmó ya no está emparejado, se quitó de tu cuenta o ya no es Admin: todas las comprobaciones la rechazan, y aún puedes revocarla. La app muestra el mismo estado como No verificable. remotxai delegations revoke <id> revoca una, y el id puede ser cualquier comienzo único de ella. Ningún comando crea una delegación: eso necesita un dispositivo Admin y su llave de acceso. Un comando ejecutado desde una terminal que arrancó un agente espera a que un dispositivo Admin lo apruebe.
remotxai provenance rotate cambia la clave con la que tu ordenador firma las delegaciones. La clave anterior sigue verificando lo que firmó durante 8 días. Si crees que la clave se filtró, ejecuta remotxai provenance rotate --compromised: la clave anterior no verifica nada desde ese momento, así que cada delegación que firmó deja de valer y creas otras nuevas desde el móvil. La clave también rota sola cada 30 días. Cada rotación queda en el registro de auditoría.
Qué se registra
Sección titulada «Qué se registra»Cada comprobación queda en el registro de auditoría del ordenador con la sesión, la acción, el repositorio y el objetivo. Una sesión nunca recibe un sí que el registro no haya guardado. Las claves, las firmas y los datos de la llave de acceso nunca aparecen en una respuesta ni en el registro. Una sesión que pregunta más de 30 veces en un minuto recibe una negativa hasta que pasa el minuto.
Límites
Sección titulada «Límites»Un programa que se ejecuta como tú en el ordenador puede leer los archivos de delegaciones. Aun así no puede crear una delegación sin tu llave de acceso. Una sesión que nunca pregunta solo la frenan tus aprobaciones de siempre.
Las sesiones de Claude Code no pueden leer ni escribir los archivos de delegaciones ni el archivo de tus secretos guardados con sus herramientas de archivos. Una sesión de Claude Code que arranca en un sandbox tampoco puede con sus comandos. No es una garantía: un enlace creado después de arrancar la sesión, o la misma ruta escrita con otras mayúsculas, puede saltarse las herramientas de archivos, y en un Mac un comando en sandbox aún puede pedir al llavero un secreto guardado. Por eso cada respuesta dice same-user por ahora. Los programas que remotxai no arrancó nunca se cuentan.