Remote Harness GitHub ↗
Cifrado de extremo a extremo · tmux · código abierto

Sigue y dirige tus agentes de código desde el móvil.

Claude Code, Codex, Gemini CLI, Kimi CLI o Qwen Code se ejecuta en tmux en tu propia máquina. Remote Harness transmite la conversación a tu móvil desde cualquier lugar, con cifrado de extremo a extremo: lees lo que hizo el agente, respondes a sus peticiones de permiso, envías el siguiente prompt y abres sesiones nuevas.

macOS · Linux · Windows (WSL2)iOS · AndroidMIT, sin cuenta, sin VPN
Funciona con Claude Code Codex CLI Gemini CLI Kimi Qwen Code Modelos de OpenRouter vía perfiles
Cómo funciona

Tu móvil, tu máquina. Nada en medio puede leerlo.

Las sesiones se ejecutan dentro de tmux. El agente cuenta lo que pasa por sus hooks nativos, un pequeño daemon en la máquina hace de puente con el móvil, y el cifrado de extremo a extremo lo mantiene todo privado.

Tu móvil

App nativa para iOS y Android. Lee la conversación, responde permisos, envía prompts, teclas, fotos y voz. Push y estado en vivo, sin contenido dentro.

Tu máquina

El daemon remote-harness: sigue los transcripts, controla tmux, recibe los hooks del agente en 127.0.0.1. Una línea para instalar, un elemento de inicio o una unidad systemd para mantenerlo en marcha.

Tus agentes, en tmux

Una ventana por sesión, un alias por perfil, para Claude Code, Codex, Gemini CLI, Kimi CLI o Qwen Code.

personal → ~/.claude
ver más
trabajo → ~/.claude-workcodex → ~/.codexgem → ~/.geminikm → ~/.kimiqw → ~/.qwenopenrouter → ~/.claude-openrouter
  1. Instala en la máquina

    Un comando. Comprueba tmux, git, ripgrep y Node, encuentra tus perfiles e instala los lanzadores.

  2. Escanea el código QR

    La instalación lo muestra al final (o remote-harness pair). En casa o fuera, el móvil encuentra la máquina, listo.

  3. Ejecuta tu alias

    trabajo abre Claude Code en tmux con ese perfil. La sesión aparece en el móvil, totalmente controlable.

Funciones

Todo lo que muestra el terminal, y las partes que el terminal no puede.

Una lista, todos los perfiles

Sesiones de todos tus perfiles, ordenadas por lo último que se movió, con una franja “esperándote” arriba.

Conversación en vivo

Markdown, razonamiento, llamadas a herramientas, diffs y resultados, transmitidos al momento y paginados hasta el principio.

Permisos desde el bolsillo

Permitir, denegar o permitir siempre. El “siempre” queda como regla escrita por el propio agente, reversible desde la CLI.

En cola o enviar ya

Encola los siguientes mensajes mientras el agente trabaja; entran en orden cuando termina el turno. Mantén pulsado para enviar al instante.

Terminal en bruto

El propio panel de tmux, para menús y todo lo que la vista estructurada no cubre, con una barra de teclas para Esc, Ctrl+C, flechas y Tab.

Abrir, reanudar, cerrar

Sesiones nuevas en cualquier carpeta, opcionalmente en su propio worktree de git. Reanuda las de solo lectura. Cierra con limpieza del worktree que nunca descarta trabajo en silencio.

Estado en vivo

Pantalla de bloqueo y Dynamic Island en iOS, una notificación silenciosa en Android: estado, tipo de paso y tiempo transcurrido, nunca el texto.

Subagentes, voz, fotos

Sigue subagentes y tareas en segundo plano, dicta prompts en el dispositivo, adjunta fotos. Autocompletado para @archivos y /comandos.

Privacidad y seguridad

El daemon es un shell remoto, así que viene cerrado por defecto.

El relay no puede leerloEn casa la app habla directamente con el daemon; fuera, a través de un relay de conexión. Ambos caminos van cifrados de extremo a extremo con Noise y claves por dispositivo, así que el relay solo reenvía bytes que no puede leer, y no guarda registros.
Claves por dispositivoCada móvil se empareja con un código de un solo uso que caduca en 5 minutos y recibe sus propias claves, guardadas en el Llavero (macOS), el Secret Service (Linux) o el almacenamiento seguro del móvil. Revoca cualquiera cuando quieras.
Push sin contenidoLas notificaciones llevan un título, un perfil y un id de sesión. El estado en vivo añade el nombre y la carpeta de la sesión, nada de la conversación.
Sin bypassLa app nunca ofrece el modo “bypass permissions” del agente. Los cambios en tus dotfiles se fusionan, se respaldan y son totalmente reversibles.
Solo si tú quieresNo se envía nada a ninguna parte sin tu elección: push con tu propio proyecto de Firebase o con el relay sin contenido, informes de errores y datos de rendimiento, siempre sin contenido de las sesiones.
Código abiertoLicencia MIT, construido a la vista con OpenSpec. Lee SECURITY.md para informar de un problema.
Instalar

Una línea en la máquina, un escaneo en el móvil.

curl -fsSL https://remoteharness.app/install | bash

Comprueba el sistema, instala lo que falte (Homebrew, apt, dnf, pacman o zypper), compila el daemon y abre la instalación guiada.

  • Node 24+ (incluido si falta)
  • tmux
  • git
  • ripgrep
  • claude, codex, gemini, kimi o qwen en el PATH

Descargar la app

iPhone y iPadTestFlight (beta) · iOS 17+ AndroidGoogle Play (prueba) · Android 10+

No hace falta nada más en el móvil. ¿Instalaste primero la app? Su pantalla de emparejamiento te guía en la instalación de la máquina.

Docs y FAQ

Las primeras preguntas

La guía completa está en la documentación: primeros pasos, uso de la app, la CLI del daemon, seguridad, resolución de problemas.

¿Funciona fuera de casa?

Sí: directamente en casa y, fuera, a través del relay de conexión con cifrado de extremo a extremo, sin abrir puertos ni VPN. La máquina tiene que estar despierta; la página Solución de problemas de la documentación cubre las opciones de suspensión y bloqueo.

¿Qué agentes están soportados?

Claude Code, Codex CLI, Gemini CLI, Kimi CLI y Qwen Code, con todos los perfiles (CLAUDE_CONFIG_DIR, CODEX_HOME, ~/.gemini, KIMI_SHARE_DIR, QWEN_HOME) en una sola lista, incluidos los perfiles de Claude Code enrutados por OpenRouter.

¿Puede ejecutar mi agente sin supervisión?

Solo hasta donde lo permiten los modos de permiso del propio agente. La app ofrece predeterminado, aceptar ediciones, plan y auto; nunca ofrece bypass. Cada permiso sigue pasando por ti, desde el móvil o la máquina.

¿Y las sesiones abiertas fuera de tmux?

Siguen apareciendo, en solo lectura. Reanuda una desde el móvil y se reabre dentro de tmux, totalmente controlable.

¿Hay algún componente en la nube?

Solo relays que no pueden leer nada. Fuera de casa el relay de conexión reenvía el tráfico cifrado de extremo a extremo (o aloja el tuyo), y el push opcional pasa por FCM (tu proyecto de Firebase o el relay de push sin contenido). Nada guarda tus sesiones.

¿El daemon necesita un Mac?

No: macOS, Linux (systemd) y Windows mediante WSL2 están soportados. La app funciona en iOS y Android.