en ejecución
Terminal real en espejo
Sin resúmenes ni transcripciones intermedias. ColliePWA renderiza la salida exacta del agente con soporte de color ANSI idéntico al de tu terminal de escritorio.
Controla tus agentes locales desde el móvil.
ColliePWA es un puente móvil al multiplexor de terminal de tu máquina. Los agentes ejecutan tareas largas en sus paneles y se detienen al requerir confirmación. ColliePWA lista los agentes activos, señala cuáles esperan respuesta y te permite contestar desde el teléfono.
- Multiplexores compatibles:
- Herdr
- tmux
- Zellij
Herdr cuenta con soporte completo en 1.0. El soporte para tmux y zellij es experimental. Detalles en Multiplexores
Interfaz real de ColliePWA con agentes de prueba. Sin conexión activa, las pulsaciones no generan acción.
01/Demostración
Pruébalo aquí.
Esta es la aplicación real de ColliePWA. Los agentes son simulados: el grupo, las terminales y las respuestas son datos de prueba en tu navegador. Nada se ejecuta en local ni se envía a la red.
- 01Abre el agente marcado como blocked. Está situado al principio.
- 02Revisa su solicitud. Muestra la salida real de la terminal de forma sincronizada.
- 03Pulsa una respuesta para reanudar el proceso.
- 04Pulsa Keys para acceder a Esc, Tab, flechas de dirección y Ctrl, teclas ausentes en teclados móviles.
02/Funcionalidad
Dos problemas resueltos y las novedades de la versión 1.0.
en bloqueos
Respuesta en un toque
Convierte los diálogos de confirmación en tres botones interactivos. Cada respuesta se valida contra el estado actual de la pantalla para evitar confirmaciones accidentales.
Novedades en 1.0
03Seis idiomas
Soporte para inglés, alemán, español, coreano, japonés y chino desde ajustes. La traducción aplica solo a la interfaz: la salida del agente se preserva intacta.
04Autorización explícita de dispositivos
El comando collie pair genera un código de ocho caracteres con validez de diez minutos o cinco intentos. El dispositivo móvil lo intercambia por un token único del cual el puente almacena solo el hash. Revoca cualquier acceso por nombre de forma inmediata.
05Entrada por voz
Mantén pulsado para grabar y transcribir directamente en el editor. Compatible con endpoints de la API de OpenAI, instancias locales de whisper.cpp o parakeet.cpp, o la sesión existente de Codex CLI sin requerir claves extra. Requiere HTTPS mediante tailscale serve.
06Notificaciones Web Push
Web Push opcional avisa cuando un agente espera respuesta o termina. Al pulsar la notificación se abre dicho agente. Los filtros de estado y el modo no molestar se aplican a todos los dispositivos. Requiere HTTPS y collie push-keys.
07Worktrees como espacios de trabajo
En Herdr, abrir un git worktree de un repositorio activo lo anida bajo dicho árbol en lugar de crear una fila independiente. La gestión recae en Herdr, manteniendo el comportamiento estándar de los espacios.
08Modo Zen
Opción por dispositivo que oculta todos los elementos de la interfaz excepto la terminal. Desactivado por defecto, ya que restringe la navegación a un único control flotante.
Punto de entrada único
09Punto de acceso configurable
ColliePWA escucha en loopback sin exponer puertos a internet. La conexión hacia el móvil puede gestionarse mediante Tailscale con collie start, redes mesh alternativas, túneles seguros o proxies inversos dedicados.
10Un acceso para múltiples máquinas
Un pack es ColliePWA en cada máquina. El móvil accede a todas a través de la máquina principal. Subidas, diario, registro de auditoría, actualizaciones y conmutación por error van por máquina, también bajo tmux y zellij. Las máquinas guardadas en Herdr siguen en su ventana. El pack es lo que ve el móvil.
Otras características
- 11Vista global del clúster
- Agentes organizados por estado de interacción requerida. Los procesos bloqueados se priorizan al inicio.
- 12Historial completo de ejecución
- ColliePWA procesa la transcripción directa del agente, permitiendo revisar la sesión completa y no solo el último búfer en pantalla.
- 13Múltiples sesiones en una sola instancia
- En Herdr expone todas las sesiones configuradas y permite alternar entre ellas desde el encabezado sin reiniciar el host.
03/Para quién es
Para desarrolladores que ejecutan agentes en un multiplexor y se alejan del escritorio.
ColliePWA está pensado para un único operador con varios agentes de código en paneles de terminal en una sola máquina. No reemplaza al terminal. Te permite responder a un agente en espera desde el móvil y seguir con lo tuyo.
- Se integra donde ya trabajas
- Se conecta al multiplexor que ya utilizas: Herdr, tmux o zellij. Sin modelos de sesión nuevos y sin envoltorios sobre el agente. Herdr cuenta con soporte completo en 1.0. tmux y zellij son experimentales.
- Sin tiendas de apps, sin nube, sin cuentas
- Una PWA servida desde tu propia máquina a través de tu tailnet. Sin registro en tiendas, sin cuentas de proveedor y sin infraestructura en la nube. Los únicos servicios externos son los que tú actives: el servicio de push del navegador y un endpoint de transcripción en la nube si prefieres no usar un motor local. Añádela a la pantalla de inicio y funciona como una app.
- Diseñado para el teclado que no tienes
- Teclas especiales, flechas y modificadores organizados en un teclado virtual. Respuestas rápidas propias y comandos slash con un solo toque. La entrada es un campo de texto plano, por lo que el dictado por voz del móvil funciona directamente. El reconocimiento de voz integrado está disponible tras ejecutar
collie stt setupbajo HTTPS. - Notificaciones cuando un agente requiere entrada
- Web Push opcional para avisarte cuando un agente se bloquea esperando datos o termina. Tocar la notificación abre ese panel. Requiere HTTPS y
collie push-keys. - Varias máquinas, una sola URL
- Un pack reúne todos tus hosts tras una única dirección, con failover preautorizado ejecutable desde el navegador. Una sola confirmación actualiza el pack entero desde la misma pantalla.
- Licencia MIT. Súmate y colabora.
- El código fuente está en GitHub bajo licencia MIT. Se agradecen reportes de errores en entornos con tmux y zellij, así como confirmaciones de configuraciones que funcionen.
04/Entorno de ejecución
Acceso directo a shell en tu máquina.
ColliePWA interactúa con terminales vivas usando los permisos de tu usuario del sistema. Cualquier cliente con acceso a la URL puede inspeccionar paneles y ejecutar comandos con tus privilegios locales. Por este motivo no existen servidores compartidos ni servicios gestionados.
- Ejecución local con los agentes
- Se acopla directamente al multiplexor en la misma máquina. Herdr es la opción estable recomendada en 1.0. El soporte para tmux y zellij es funcional pero experimental. No requiere servidores externos ni cuentas de usuario.
- Interfaz loopback y entrada única
- El servicio escucha solo en localhost, nunca en 0.0.0.0. Requiere exponer un único punto de entrada autenticado mediante tailscale serve o proxy inverso local. No uses configuraciones tipo funnel.
- Autenticación a nivel de dispositivo
- La pasarela de acceso valida la identidad del nodo conectado, no la del usuario físico. Sin capa de login adicional, un terminal móvil desbloqueado otorga acceso directo a la shell.
- Aislamiento entre usuarios locales
- El socket del multiplexor usa permisos de archivo estándar en disco. El puerto HTTP de ColliePWA utiliza TCP local sin aislamiento de usuario nativo. Se recomienda restringir el acceso con COLLIE_TRUSTED_USER en Tailscale o reglas de firewall.
Código abierto bajo licencia MIT. Revisa la guía de seguridad detallada antes del despliegue en producción.
05/Instalación
Instalación con un comando o compilación local.
ColliePWA se ejecuta en el mismo host que tus agentes. El script descarga el binario verificado de tu plataforma. Compilar desde la fuente requiere git y Bun, útil para arquitecturas sin binarios oficiales. Ambas opciones dejan collie en el PATH sin iniciar servicios.
$ curl -fsSL https://colliepwa.dev/install.sh | sh
Un script en sh POSIX simple. No requiere sudo, no levanta daemons y solo escribe en ~/.local/share/collie y ~/.local/bin. Descarga la última versión estable, valida el hash sha256 publicado, ubica el binario y añade el ejecutable al PATH. Requiere curl, tar y utilidades sha256 básicas. No necesita herramientas de compilación.
Esta URL sirve una copia estática. El archivo original está en scripts/install.sh dentro del repositorio. Conviene auditar el script antes de ejecutarlo:
$ curl -fsSL https://raw.githubusercontent.com/AltanS/collie/main/scripts/install.sh | less$ curl -fsSL https://raw.githubusercontent.com/AltanS/collie/main/scripts/install.sh | sh
Para actualizar instalaciones binarias, collie update descarga la versión reciente, valida la firma y reinicia. La versión anterior permanece en disco, permitiendo revertir con collie update --rollback. En instalaciones desde la fuente, la actualización se realiza mediante git sin historial de versiones binarias.
Sincronizado desde scripts/install.sh en 2ded11d, 2026-08-31.
Solo queda un paso: iniciarlo.
# one step left. It asks which multiplexer to mirror — herdr, tmux or# zellij — and writes your answer to ~/.config/collie/.env, creating it.$ collie start
La configuración es opcional y se guarda en ~/.config/collie/.env, el archivo que crea start. Define ahí COLLIE_TRUSTED_USER, además del puerto o el punto de acceso si los valores por defecto no te sirven.
Abre la URL resultante en el navegador del móvil dentro de la red correspondiente. Puedes añadir el sitio a la pantalla de inicio como PWA.
Acceso de red privado: ColliePWA escucha únicamente en loopback y no expone puertos públicos. Se requiere un mecanismo de transporte hacia el móvil. Tailscale es la opción por defecto: collie start utiliza tailscale serve y genera un dominio MagicDNS accesible. También es posible configurar otra VPN mesh, un túnel o un proxy inverso propio según se detalla en DEPLOYMENT.md. ColliePWA está diseñado para un único operador sin perfiles compartidos.
Requisitos, métodos de instalación y salida del primer inicio