Ir al contenido

Instala en tu ordenador

Instala remotxai en el ordenador donde corren tus agentes. Funciona en segundo plano y arranca al iniciar sesión.

  • macOS (Apple silicon o Intel) o Linux (x64). Sin Windows.
  • Un usuario normal. El instalador no corre como root.
  • curl y tar en el ordenador.
  • Entre 170 MB y 185 MB de descarga y entre 490 MB y 510 MB de disco. Node.js va incluido.
  • claude, codex o pi instalados y con la sesión iniciada. remotxai no inicia sesión por ti.
  1. Abre una terminal en el ordenador.
  2. Ejecuta:
Ventana de terminal
curl -fsSL https://app.remotxai.com/install.sh | sh

El instalador comprueba la firma y el hash de lo que descarga, lo descomprime en ~/.remotxai, añade ~/.remotxai/bin al perfil de tu shell y arranca el servicio en segundo plano. En una terminal interactiva ejecuta después remotxai up por ti y abre el navegador, así que puedes pasar directamente a Conecta tu ordenador a tu cuenta. En un script imprime el comando que debes ejecutar. El servicio necesita un programa de agente en tu ruta: si no hay ninguno instalado se detiene y dice que no llegó a estar listo, así que instala uno, inicia sesión y ejecuta remotxai service install otra vez.

  1. Abre una terminal nueva para que el comando remotxai esté en tu ruta.

Ejecuta:

Ventana de terminal
remotxai doctor

Todas las líneas deben decir PASS. WARN no importa hasta que uses esa función. FAIL dice qué arreglar; consulta la solución de problemas.

En Linux, las funciones de terminal son limitadas por ahora. Las sesiones que inicias desde el móvil funcionan con normalidad.

En macOS: deja que Remotxai entre en tus carpetas

Sección titulada «En macOS: deja que Remotxai entre en tus carpetas»

En un Mac el servicio funciona como una app llamada Remotxai (~/Applications/Remotxai.app). macOS pregunta una vez por carpeta antes de dejarla entrar en Descargas, Escritorio o Documentos.

  • Cuando macOS pregunte si Remotxai puede acceder a una carpeta, pulsa Permitir.
  • Si pulsaste No permitir, activa la carpeta en Ajustes del Sistema, Privacidad y seguridad, Archivos y carpetas, Remotxai.

Permite solo las carpetas que tus agentes necesitan. No añadas Remotxai a Acceso total al disco.

Si un agente falla con Operation not permitted, remotxai doctor muestra una línea folder access con la carpeta rechazada.

Lo permites una vez. Las actualizaciones cambian el runtime de ~/.remotxai y no tocan la app, así que macOS conserva tu elección. macOS ata la elección al lanzador exacto de la app, que tu ordenador compila y firma por su cuenta. Compilar el lanzador necesita las herramientas de línea de comandos de Xcode (xcode-select --install). Sin ellas el servicio funciona como node a secas, que macOS no puede listar, y remotxai doctor lo dice. En la rara versión que cambie el lanzador, service install dice que ha rehecho la app y macOS vuelve a preguntar.

El lanzador de la app solo arranca los runtimes de remotxai de ~/.remotxai/runtime: su propio node con la entrada del servicio, nada más, y quita las variables NODE_OPTIONS y DYLD_*. Un programa que corra con tu usuario todavía puede editar los archivos del runtime en ~/.remotxai y reiniciar el servicio, y el código cambiado obtiene entonces las carpetas que permitiste. Así que trata las carpetas que permites a Remotxai como carpetas a las que cualquier programa de tu usuario puede llegar a través de ella.

remotxai service uninstall borra la app y restablece su acceso a carpetas. --keep-app conserva las dos cosas, por ejemplo antes de reinstalar.

Ejecuta:

Ventana de terminal
remotxai up

Abre la página de aprobación con el código ya puesto, e imprime la página y el código. Por SSH o sin pantalla imprime un código QR; --no-browser hace lo mismo.

  1. Inicia sesión en la página si te lo pide. La página obtiene el código de comprobación del propio ordenador, a través de una página en 127.0.0.1, y lo muestra encima de un botón Añadir {ordenador}: Comprueba que coincide con tu terminal. La huella está en Detalles.
  2. Compara el código con la línea check code de tu terminal. Si coinciden, pulsa Añadir {ordenador} y confirma con tu llave de acceso. Si no, pulsa Cancelar.

Si abriste tú la página impresa, o en otro dispositivo, la página muestra la huella y, si tu navegador puede aprobar ordenadores en la organización, un código de comprobación junto a Aprobar. Compáralo con la línea check code de tu terminal y marca El código del ordenador coincide antes de pulsar Aprobar.

No escribes nada en la terminal. Justo después de aprobar, la página hace la entrega al ordenador a través de una página en 127.0.0.1 y vuelve. La terminal muestra la cuenta, el navegador que aprobó y la organización, para que compruebes que son tuyos. Si no llega ninguna entrega en 30 segundos, por ejemplo porque aprobaste desde el móvil, la terminal pide la contraseña de inicio de sesión del ordenador o Touch ID, con la cuenta y la organización que lo aprobaron en el mensaje. Si el sistema no puede pedirla, te pide que escribas el correo de la cuenta.

La página acaba en Ya puedes cerrar esta pestaña cuando el ordenador está listo, y la terminal acaba en una sola línea, en inglés: Ready. <ordenador> is in <organización>. Si tu navegador no puede aprobar ordenadores, el ordenador se une igualmente pero queda en espera: la página y la terminal dicen que un administrador de la organización tiene que aprobarlo, y los administradores lo ven en Inicio y en su fila de Ordenadores.

Después aparece en Ajustes, Ordenadores. remotxai up necesita una terminal interactiva. Si el código caduca, ejecútalo otra vez.

Un ordenador pertenece a una sola organización a la vez. Para moverlo, ejecuta remotxai logout y después remotxai up.

Si eres el primero de una organización nueva

Sección titulada «Si eres el primero de una organización nueva»

El primer ordenador de una organización es permanente, así que antes de crear la organización el ordenador te pide una vez la contraseña de inicio de sesión o Touch ID. Si la página de aprobación la abrió remotxai up en este ordenador, esa misma petición aprueba también el navegador con el que aprobaste. El navegador toma los códigos de la organización del ordenador a través de 127.0.0.1 y la página acaba en {ordenador} está listo, sin códigos que escribir. La terminal imprime una línea con el navegador, tu cuenta, un id corto del dispositivo y su acceso. remotxai up --verbose imprime además los límites del navegador y los códigos de la organización.

Si el sistema no puede pedirte la contraseña, el ordenador queda pendiente hasta que apruebes tu primer navegador. En el navegador que abrió remotxai up, la app muestra Aprobar en mi ordenador. Elígelo mientras ese remotxai up sigue esperando, hasta 10 minutos. La terminal te pide la contraseña o Touch ID, o, si el sistema no puede pedirla, el código de dispositivo de 16 caracteres que muestra el navegador. Solo ese navegador puede ser el primero. Un navegador en otro dispositivo inicia sesión con tu llave de acceso cuando el primero ya está dentro.

Si remotxai up dejó de esperar antes de aprobar tu primer navegador, vuelve a ejecutar remotxai up en el escritorio del ordenador. Abre tu navegador en el mismo paso: inicia sesión, toca Aprobar en mi ordenador y confirma con tu contraseña o Touch ID. Puedes hacerlo en cualquier momento de las 24 horas que el ordenador queda pendiente. Cuando pasen, remotxai up te pide aprobar el ordenador otra vez y empieza otras 24 horas.

El primer ordenador de una organización necesita una sesión de escritorio en ese ordenador, porque solo un navegador que abre allí remotxai up puede ser tu primer navegador. Apruébalo en el navegador que abrió remotxai up en el ordenador. Si esa página no pasa al ordenador en 30 segundos, remotxai up se detiene antes de crear la organización y no firma nada. Pasa por SSH, sin pantalla, con --no-browser o --verify, cuando el navegador no se abrió, cuando bloquea las páginas en 127.0.0.1 o cuando aprobaste en otro dispositivo. Ejecútalo otra vez desde la sesión de escritorio del propio ordenador y aprueba en el navegador que abre. Los ordenadores posteriores de la organización pueden unirse por SSH o sin pantalla.

El ordenador tiene que confiar en el código de la cuenta de la organización. Si aprobaste desde un navegador de este ordenador que ya está aprobado en la organización, el navegador entrega a la terminal su propia copia del código y el ordenador la comprueba. Si no coinciden, se detiene con un error y no confía en nada. Aunque coincidan, cuenta como aún sin comparar, porque la página que leyó la copia del navegador también la sirve el servicio de remotxai.

Si no, el ordenador confía en el código en el primer uso y lo dice: Pinned <organización>'s account code on first use. Imprime el código de la cuenta y el código del último cambio. Compáralos con un dispositivo que ya esté en la organización ejecutando remotxai lock verify; hasta entonces, remotxai status, remotxai doctor y la app marcan la fijación como aún sin comparar. Para comparar antes de confiar en nada, ejecuta remotxai up --verify, que te pide el correo de tu cuenta y los dos códigos. Si la organización aún no tiene ningún ordenador, su propietario tiene que conectar primero uno personal.

Siguiente: empieza tu primera sesión. Para conectar un móvil directamente a este ordenador, empareja tu móvil.