Referencia de comandos
Ejecútalos en tu ordenador. Todo lo demás se hace en la app. La terminal responde en inglés.
Instalar
Sección titulada «Instalar»curl -fsSL https://app.remotxai.com/install.sh | shInstala remotxai y arranca su servicio. Detalles: Instala en tu ordenador.
Conectar el ordenador a tu cuenta: remotxai up
Sección titulada «Conectar el ordenador a tu cuenta: remotxai up»remotxai upAbre en tu navegador la página de aprobación con el código ya puesto. Aprueba este ordenador allí. La terminal muestra la cuenta, el navegador que aprobó y la organización; no hay que escribir nada. El código viaja en la parte de la dirección que va detrás de #, que ningún servidor ve. La terminal también imprime la página, el código y un código de comprobación, por si prefieres abrirla tú. Necesita una terminal interactiva.
Por SSH, sin pantalla o con --no-browser, no se abre nada. La terminal imprime la página, el código y un código QR. --qr imprime el QR aunque se abra el navegador.
Aprobar un ordenador requiere una llave de acceso, en la página que abrió remotxai up o en cualquier dispositivo con tu cuenta abierta. Un ordenador que se une a una organización sigue sin pedir nada solo cuando el navegador que abrió hace la entrega a través de una página en 127.0.0.1 antes de terminar; si no, pide tu contraseña de inicio de sesión o Touch ID, o el correo de la cuenta si el sistema no puede pedirla. Comprueba su código de la cuenta con la copia de ese navegador, o si no confía en él en el primer uso y lo dice. En los dos casos queda marcado como sin comparar hasta que remotxai lock verify lo compara con un dispositivo que ya esté en la organización. remotxai up --verify pide el correo de tu cuenta y los dos códigos antes de confiar en nada, como las versiones anteriores. El primer ordenador de una organización nueva pide la contraseña de inicio de sesión de tu Mac (la que usas para desbloquearlo, no una contraseña de remotxai) o Touch ID antes de crearla.
remotxai up termina con una línea en inglés: Ready. <ordenador> is in <organización>. Si algo lo bloquea, como una aprobación pendiente de un Administrador, la línea dice qué hacer.
En un ordenador ya conectado, remotxai up imprime la misma línea. Después de remotxai down, lo reconecta. remotxai down lo desconecta sin quitarlo de tu cuenta. En un ordenador de otra organización, remotxai up --org <nombre> te dice cómo moverlo.
remotxai up --sharedDa de alta el ordenador como compartido, o convierte uno personal que ya está dado de alta. Imprime qué significa compartido y te pide escribir shared. En una conversión espera después hasta 15 minutos a que un propietario o administrador de la organización apruebe en la app. Mira Convertir un ordenador en compartido.
Aprobar tus dispositivos
Sección titulada «Aprobar tus dispositivos»El primer navegador de tu organización es el que remotxai up abrió en su primer ordenador: Aprobar en mi ordenador pasa allí su código a la terminal, que lo vuelve a calcular, muestra los límites y te pide la contraseña de inicio de sesión de tu Mac o Touch ID. Una línea sobre el aviso nombra al usuario y dice que no es una contraseña de remotxai. Solo funciona mientras ese remotxai up sigue esperando, hasta 10 minutos. Si terminó sin ningún navegador, vuelve a ejecutar remotxai up en el escritorio de ese ordenador, en cualquier momento de sus 24 horas: abre tu navegador en el mismo paso. El primer ordenador necesita una sesión de escritorio: si la página que abrió remotxai up no pasa al ordenador en 30 segundos (por SSH, sin pantalla, con --no-browser o --verify, o si aprobaste en otro dispositivo), remotxai up se detiene antes de crear la organización.
Cada navegador o móvil posterior solo inicia sesión, con tu llave de acceso, con Google, con un enlace por correo o con un código de recuperación, y eso es todo lo que necesita para llegar a tus propios ordenadores Personales y a los ordenadores que una organización comparte contigo. No hay código de aprobación que escribir ni escanear, ni otro dispositivo al que recurrir.
remotxai devicesEn un ordenador conectado, remotxai devices muestra el código de cuenta y el último código de cambio, y luego lista tus dispositivos de la organización por número, los números que usan revoke y set-ceiling.
Una aprobación termina a los 365 días. Desde 30 días antes, Inicio lista cada dispositivo cuya aprobación termina y Cuenta muestra la fecha. Un navegador que aprobó el dispositivo, o uno por encima de ese navegador en la cadena de aprobaciones, puede renovarla ahí con Renovar y tu llave de acceso. Renueva el mismo rol y los mismos límites por otros 365 días. Si no, la app indica el comando que hay que ejecutar en el primer ordenador: remotxai lock renew <id-de-dispositivo>.
Revocar un dispositivo perdido: remotxai devices revoke
Sección titulada «Revocar un dispositivo perdido: remotxai devices revoke»remotxai devices revoke 2remotxai devices set-ceiling 2 --role viewer --actions noneEn un ordenador conectado como tuyo, remotxai devices revoke lista tus dispositivos y revoca el que indiques por número de lista o por id de dispositivo, después de que escribas su nombre. Pierde el acceso a todos los ordenadores de la organización en pocos segundos y sus claves dejan de ser de confianza para siempre. Para usarlo otra vez necesita claves nuevas y un inicio de sesión nuevo con tu llave de acceso. Si es el último dispositivo que puede aprobar otros, el comando te lo dice antes. remotxai devices set-ceiling cambia el rol, los ordenadores o las acciones de cuenta de un dispositivo aprobado, solo para un dispositivo que aprobó este ordenador y nunca por encima del acceso de este ordenador, después de que escribas el resumen del nuevo límite. Ambos necesitan una terminal interactiva.
Desde la app, un dispositivo aprobado en Cuenta, Dispositivos ofrece Revocar. Para cortar el acceso a un ordenador perdido, pulsa Revocar en él en Cuenta, Ordenadores: no se cambia nada en la máquina, pero ningún dispositivo vuelve a llegar a ella.
Si remotxai lock status muestra SUSPENDED junto a un dispositivo, ese dispositivo firmó dos cambios distintos del historial de la cuenta en el mismo punto, algo que solo hace una clave robada o copiada. Este ordenador rechaza desde entonces todo lo que firme. Revócalo desde otro dispositivo u ordenador que pueda hacerlo, compruébalo con su dueño y luego ejecuta remotxai lock confirm-fork <id-del-dispositivo> en este ordenador y escribe la confirmación que pide, para que este ordenador acepte la revocación.
Mover un ordenador a otra organización: remotxai logout
Sección titulada «Mover un ordenador a otra organización: remotxai logout»remotxai logoutremotxai upUn ordenador pertenece a una sola organización a la vez. remotxai logout lo saca. remotxai up lo conecta a la nueva. Si no se llega al servicio, remotxai logout --local quita solo el estado local.
Emparejar un móvil: remotxai pair
Sección titulada «Emparejar un móvil: remotxai pair»Empareja un móvil directamente con un ordenador. No lo necesitas si iniciaste sesión y conectaste el ordenador con remotxai up.
El emparejamiento nuevo está desactivado por defecto. remotxai pair setup se niega, y no se admite ningún móvil nuevo, salvo que el daemon se ejecute con REMX_LEGACY_PAIRING=1. Los móviles ya emparejados siguen funcionando. Un ordenador que tiene un emparejamiento y no está en una organización lo dice en remotxai status y remotxai doctor.
En un ordenador que usa el relay de remotxai, el emparejamiento terminó. Los móviles y navegadores emparejados ya no se conectan, ni con REMX_LEGACY_PAIRING=1: inicia sesión en la app y el ordenador aparece en tu organización. Allí solo siguen funcionando remotxai pair list y remotxai pair revoke, para limpiar las entradas antiguas.
| Comando | Qué hace |
|---|---|
remotxai pair |
Abre el emparejamiento y espera el código de verificación del móvil. |
remotxai pair setup |
Imprime el código QR y los enlaces. |
remotxai pair enable 10m |
Abre una ventana de emparejamiento de 10 minutos (el máximo predeterminado). |
remotxai pair list |
Lista los móviles emparejados con sus huellas y roles. |
remotxai pair revoke <prefix> |
Quita el móvil cuya huella empieza por <prefix>. |
remotxai pair role <prefix> <role> |
Cambia el rol de un móvil: viewer, approver, driver o admin. |
remotxai pair label <prefix> <name> |
Renombra un móvil. El registro de auditoría nombra con este nombre al móvil que aprobó, envió un prompt o terminó una sesión. |
Pasos: Empareja tu móvil.
Comprobar la instalación: remotxai doctor
Sección titulada «Comprobar la instalación: remotxai doctor»remotxai doctorImprime PASS, WARN, FAIL o SKIP por comprobación y termina con error si alguna falla. --json da salida legible por máquinas. No imprime claves ni ajustes.
En un ordenador de una organización, la fila access list falla cuando la lista de acceso guardada del ordenador ya no se abre. Los compañeros quedan rechazados hasta que borres el archivo que nombra la fila, y entonces el ordenador vuelve a pedir la lista. El propietario conserva el acceso mientras tanto. Compartir un ordenador explica las listas de acceso.
Comprobar que funciona: remotxai status
Sección titulada «Comprobar que funciona: remotxai status»remotxai statusImprime una línea que dice si remotxai está en marcha y enlazado con el relay, el número de dispositivos y de sesiones, y cualquier fila que pida una acción. remotxai status --verbose añade la versión, el relay y los detalles del plan, y las últimas 20 veces que se conectó un teléfono o un navegador: cuánto tardó el ordenador desde que se abrió la conexión hasta el final de su primera respuesta, cuántos mensajes y bytes envió, y la mediana y el percentil 95 de cada cifra. Las cifras no llevan nombres ni contenido de sesiones. --json da salida legible por máquinas.
Completar comandos con Tab: remotxai completion
Sección titulada «Completar comandos con Tab: remotxai completion»source <(remotxai completion zsh)Añade esa línea a ~/.zshrc (después de compinit), o a ~/.bashrc con bash. En fish, ejecuta remotxai completion fish > ~/.config/fish/completions/remotxai.fish. El script no cambia nada por sí solo.
Usar el ordenador desde su terminal: remotxai tui
Sección titulada «Usar el ordenador desde su terminal: remotxai tui»remotxai tuiremotxai tui --plainremotxai tui --no-qrremotxai tui open <sesión>remotxai tui --forgetInicia sesión en el daemon en marcha como el dispositivo de terminal de este ordenador y abre una vista a pantalla completa: la lista de sesiones y, al abrir una, su transcripción, un cuadro de mensaje y una tarjeta por cada aprobación o pregunta que espera. Las respuestas se muestran como markdown con formato: tablas en cajas ajustadas a la terminal, bloques de código, listas, citas y títulos. Cada llamada a una herramienta ocupa una línea, con el nombre de la herramienta separado de lo que ejecutó y un punto que indica si sigue en marcha. Los procesos en segundo plano de la sesión aparecen encima del cuadro de mensaje con cuánto llevan en marcha o cómo terminaron, y un mensaje que espera en la cola aparece ahí una sola vez, marcado como en cola, hasta que el agente lo toma. NO_COLOR quita el color. En una aprobación de una llamada normal a una herramienta, 1 la permite una vez y 2 la deniega. La tarjeta muestra el nombre de la herramienta y toda la entrada, con saltos de línea. Si la llamada es demasiado larga para mostrarla entera, o el ordenador no envió su entrada al terminal, 1 no hace nada y la tarjeta dice que la permitas en la app; 2 sigue denegando. Una tarjeta que solo puede responder una persona (la marcada como solo para personas, la que maneja el propio remotxai o la que cambia el modo de la sesión) acepta los mismos 1 y 2 mientras la ventana de presencia está abierta. Sin ventana dice Open the presence window to answer y p abre una con Touch ID; por SSH o sin Touch ID dice Sign on phone. Cada tarjeta muestra si la ventana está abierta y cuánto le queda, y cada respuesta a una de esas tarjetas bajo la ventana hace sonar la campana de la terminal y deja una línea que dice qué se respondió. Un cambio de modo dice además qué concede, durante cuánto tiempo y en qué sesión antes de que funcione una tecla. ctrl+l bloquea la ventana y ctrl+x descarta su clave al momento; un segundo ctrl+x detiene todas las sesiones, y el ordenador solo lo acepta desde la terminal con su ventana abierta. Mientras hay una ventana abierta, un programa que pueda escribir en esta terminal, como un agente en el mismo tmux, puede responder la tarjeta en pantalla, así que bloquea la ventana antes de irte. Las preguntas también se responden aquí: elige una opción por su número o con las flechas y espacio, escribe tu propia respuesta o una nota donde la pregunta lo admite y pulsa enter; d la rechaza y c la cancela. Un formulario sigue yendo a la app. Las teclas esperan un momento cuando aparece una tarjeta, para que una tecla pensada para el cuadro de mensaje no la responda. Desde la terminal puedes enviar mensajes, interrumpir un turno, recuperar con up tu último mensaje en cola para editarlo, responder una vez a la tarjeta en pantalla, responder preguntas, bajar el modo de una sesión con shift+tab y deshacer tu propio mensaje o bajada. El ordenador le rechaza todo lo demás, como una tarjeta solo para personas sin la ventana ni la passkey de tu cuenta, aprobar todas las llamadas parecidas, cambiar lo que ejecuta una llamada, responder por voz, subir un modo desde el cuadro de mensaje, aceptar un formulario, cancelar un mensaje que puso en cola otro dispositivo, cambiar ajustes, plugins o permisos, añadir una passkey o firmar, y anota el rechazo en el registro de auditoría. enter abre la sesión marcada, tab vuelve a la lista, esc interrumpe un turno en marcha y ctrl+c dos veces sale. Sin terminal, o con --plain, imprime la lista de sesiones y termina. La primera vez pregunta antes de añadir la terminal como dispositivo Admin llamado TUI on <ordenador>; --yes se salta la pregunta y --label elige otro nombre. Con un bloqueo de organización recibe tu rol en este ordenador, y cada inicio de sesión lo vuelve a bajar si tu rol allí bajó. El dispositivo habla con el daemon por su propio socket en este ordenador, nunca a través del relay, y aparece en la lista de dispositivos de tu móvil con la etiqueta App de terminal, donde puedes revocarlo. --forget lo revoca desde la terminal y borra su clave.
En un Mac, la terminal también puede responder con Touch ID. ctrl+t añade la clave de Touch ID de esta terminal. En un ordenador personal de tu organización abre tu navegador en una página que muestra la huella de la clave, la misma que muestra la terminal, y lo confirmas con Touch ID para la passkey de tu cuenta. No hace falta el móvil, y un agente no puede hacerlo por ti. Cierra la página si no pulsaste ctrl+t. En cualquier otro ordenador apruebas la clave con una passkey desde otro dispositivo, nunca desde la terminal. Después, una tarjeta marcada como solo para personas ofrece 3 para permitirla una vez y 4 para denegarla, cada una con un aviso de Touch ID que nombra la solicitud y la respuesta. ctrl+w abre una ventana con un solo Touch ID: durante hasta 5 minutos sin actividad, y 15 como máximo, 1 y 2 responden tarjetas normales sin volver a preguntar. ctrl+g abre la misma ventana desde tu móvil, con una passkey o un código de autenticador. Una ventana abierta con un código de autenticador solo responde tarjetas normales; una tarjeta solo para personas necesita una ventana abierta con Touch ID o una passkey. La ventana termina al pulsar ctrl+w otra vez, salir de la terminal, bloquear la pantalla, pulsar pánico o revocar el dispositivo, y el registro de auditoría nombra la ventana en cada respuesta que llevó. Por SSH y en Linux no hay Touch ID ni ventana. La tarjeta de la app para aprobar la clave de Touch ID de una terminal llega en una actualización posterior; hasta entonces la terminal manda estas tarjetas a tu móvil como antes.
Sin ventana, 1 o 2 en una tarjeta solo para personas pide la passkey de tu cuenta para esa única respuesta. Vale para una tarjeta marcada como solo para personas, una que maneja el propio remotxai, un cambio de modo y una que llega más allá de la llamada, y funciona en Linux, por SSH y en un ordenador sin Touch ID. En una sesión de escritorio la terminal abre una página de confirmación en tu navegador. Por SSH, en tmux o screen, como root o sin navegador, imprime una dirección corta, un código y un código QR de la dirección con el código ya puesto: ábrela en cualquier dispositivo con tu cuenta iniciada, o escanea el QR con tu móvil. La página muestra la solicitud en palabras claras, el ordenador y la terminal, y te pide confirmar antes de pedir la passkey. El código responde esa única tarjeta y caduca en 5 minutos. El QR solo lleva la dirección y el código, y la terminal lo omite cuando es más estrecha que el código; --no-qr lo omite siempre. El ordenador comprueba la passkey con su propio bloqueo de organización antes de aceptar la respuesta, así que un agente que escribe en la terminal no puede aprobar. Los permisos y aprobar todas las llamadas parecidas siguen rechazados desde una terminal, y un ordenador compartido no tiene passkey de propietario que pedir, así que esas tarjetas van a tu móvil.
remotxai tui open <sesión> abre una sesión por su id, el principio de su id o su etiqueta. Imprime los últimos 20 turnos y después todo lo que el agente dice y hace mientras ocurre, y cada línea que escribes llega a la sesión como tu mensaje, desde este dispositivo de terminal, igual que un mensaje desde tu móvil. Mientras está abierta, la sesión muestra la terminal entre quienes la ven. ctrl+d sale. Un ordenador admite como mucho 4 por dispositivo de terminal y 8 en total.
Responder una tarjeta desde la línea de comandos: remotxai approve
Sección titulada «Responder una tarjeta desde la línea de comandos: remotxai approve»remotxai approve <sesión>remotxai approve <sesión> <id-de-solicitud>remotxai approve <sesión> <id-de-solicitud> --denyResponde una tarjeta de aprobación como el dispositivo de terminal de este ordenador, la misma respuesta que envían 1 o 2 en remotxai tui. Solo con una sesión (su id, el principio de su id o su etiqueta) lista las tarjetas que espera esa sesión y marca las que solo puede responder una persona. Con un id de solicitud permite esa tarjeta una vez, o la deniega con --deny. Una tarjeta solo para personas pide la passkey de tu cuenta igual que la app de terminal, en el navegador de este ordenador o con una dirección, un código y un código QR para abrir en cualquier dispositivo. --via browser o --via device elige el camino y --no-qr omite el QR. Ejecuta antes remotxai tui una vez para que la terminal sea un dispositivo del ordenador. remotxai approvals es otro comando: gestiona las aprobaciones permanentes.
Delegaciones permanentes: remotxai delegations
Sección titulada «Delegaciones permanentes: remotxai delegations»remotxai delegations [list] [--json]remotxai delegations revoke <id>remotxai provenance rotateremotxai provenance rotate --compromisedremotxai delegations lista lo que tus sesiones pueden hacer sin preguntar, con el alcance, la caducidad, los usos restantes y el estado de cada delegación; --json imprime esa lista como JSON y solo funciona con list. revoke termina una al instante; <id> puede ser cualquier comienzo único de ella. remotxai provenance rotate cambia la clave con la que el ordenador firma las delegaciones, y --compromised revoca la clave anterior para que nada de lo que firmó valga. Nada de esto crea una delegación: eso necesita un móvil Admin y su llave de acceso. Delegaciones permanentes.
Actualizar: remotxai upgrade
Sección titulada «Actualizar: remotxai upgrade»remotxai upgrade --checkremotxai upgrade--check indica si hay una versión nueva sin descargarla. remotxai upgrade la instala. Pregunta antes de reiniciar un servicio en marcha, porque el reinicio detiene las sesiones en curso. Para volver atrás, ejecuta remotxai service rollback.
Cambiar el perfil de una sesión: remotxai sessions switch-profile
Sección titulada «Cambiar el perfil de una sesión: remotxai sessions switch-profile»remotxai sessionsremotxai sessions switch-profile <session-id> <profile>remotxai sessions lista los id de sesión. switch-profile mueve una sesión en marcha de Claude Code, Codex o Pi a otro perfil del mismo agente y conserva la conversación. Se rechaza mientras haya un turno, una aprobación o una llamada a herramienta en curso.
Hay dos límites. El rechazo dice qué hacer:
- Deben quedar 256 MiB de disco libres después de la copia. Libera espacio y vuelve a intentarlo.
- Un mensaje puede pesar como máximo 8 MiB en Claude Code o 32 MiB en Codex y Pi. Una conversación de Claude Code puede tener como máximo 1 millón de registros. Limpia la conversación y cambia la nueva. La anterior queda en el perfil original.
| Código de salida | Significado |
|---|---|
| 0 | Cambio hecho. |
| 3 | Rechazado. No cambió nada. |
| 4 | El agente no arrancó, así que la sesión volvió al perfil anterior. |
| 5 | Se detuvo a medias. Comprueba qué cuenta está en marcha y ejecuta remotxai sessions clear-switch-recovery <session-id>. |
Más: Perfiles y cuentas.