zcode-acp-remote
Cliente remoto móvil para zcode-acp que permite conectar desde un teléfono Android al servidor del Hub y ejecutar sesiones de agente en tiempo real.
Ficha actualizada 23 sept 2026, 2:58 · upstream 23 sept 2026, 2:25 · release v0.9.4
Qué es zcode-acp-remote
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
zcode-acp-remote es un cliente remoto móvil diseñado para conectarse a las sesiones de agente del editor zcode-acp a través de una conexión WebSocket. Permite interactuar con el entorno del editor desde un teléfono Android, incluyendo la aprobación de llamadas a herramientas y respuestas a preguntas del asistente.
El cliente se puede iniciar tanto en sesiones existentes como en nuevas sesiones creadas en proyectos conocidos del Hub (versión 0.17.0+). El servidor del Hub genera un puente invisible para cada proyecto conocido, permitiendo que el agente corra dentro de ese contexto específico.
La aplicación soporta chat con respuestas en tiempo real, resaltado de código y Markdown, además de permitir la aprobación de permisos de herramientas y respuestas a formularios AskUserQuestion. Estas interacciones se pueden realizar incluso cuando el teléfono está desconectado del servidor, ya que las respuestas se reenvían tras una reconexión.
Se implementa un sistema de cola de prompts por sesión, donde los borradores se mantienen activos tras reiniciar la aplicación. Incluye completación de comandos con slash y habilidades prefijadas con signo $, además de un panel de uso con colores de estado (verde→amarillo→rojo) que indica el nivel de actividad del agente.
La reconexión con replay permite recuperar mensajes perdidos tras una desconexión transitoria. La interfaz está disponible en inglés y chino simplificado.
- Conectar desde un teléfono Android para interactuar con sesiones de agente del editor zcode-acp
- Aprobar llamadas a herramientas del asistente y responder preguntas durante la edición
- Acceder al historial de proyectos conocidos del Hub desde cualquier dispositivo móvil
- Reconectarse tras una desconexión transitoria sin perder contexto de sesión activa
- Compartir sesiones con múltiples dispositivos móviles mediante el mismo token remoto
- Soporta reconexión automática tras desconexiones transitorias con replay del historial
- Permite iniciar nuevas sesiones desde proyectos conocidos del Hub sin necesidad de reiniciar el editor
- Interfaz en inglés y chino simplificado con soporte para Markdown y resaltado de código
- Panel de uso visual que muestra el estado de actividad del agente (corriendo, inactivo, terminado)
- Soporta completación de comandos con slash y habilidades prefijadas con signo $
- Requiere un servidor zcode-acp-server hub activo en la misma red o mediante tunel HTTPS
- El token se almacena en localStorage del navegador, lo que limita su uso en dispositivos compartidos sin protección de sesión
- La reconexión con replay no recupera mensajes perdidos tras una desconexión completa (no reinicio)
- No incluye autenticación de dos factores ni cifrado adicional para la transmisión WebSocket
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere un servidor zcode-acp-server hub activo en el mismo entorno, con token ZCODE_ACP_REMOTE_TOKEN configurado al iniciar el puente,El puerto por defecto es 5173 sobre HTTPS (el cliente se conecta a wss:// y el servidor puede usar https o http),Se recomienda desplegar el servidor hub en un entorno de producción separado del cliente móvil para evitar problemas de seguridad,Para despliegue web, se pueden utilizar Netlify, Cloudflare Pages o cualquier hosting estático que soporte HTTPS,La versión web no requiere backend propio: el servidor del Hub actúa como proxy y expone CORS con Allow-Origin: *,Se recomienda mantener un registro de tokens remotos en un repositorio seguro para evitar fugas de credenciales
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.