Instalación en cinco minutos

Esta guía configura Collie en el teléfono. Instale tres herramientas en su ordenador, inicie Collie y empareje el teléfono.

Utiliza la configuración recomendada: Tailscale como punto de entrada, Herdr como multiplexor y el script de instalación. Para otras configuraciones, consulte Instalación.

Nota. Collie proporciona acceso remoto a la shell de su máquina por diseño. Lea Seguridad antes de instalarlo.

Requisitos previos

• —
  Un ordenador con Linux o macOS (el host). Un Mac requiere Apple Silicon y macOS 13 o superior.
• —
  Un teléfono iPhone o Android.
• —
  Una cuenta de Tailscale.

1. Instalar Tailscale

Tailscale conecta el host y el teléfono en una red privada, su tailnet. Collie solo es accesible a través de esa red.

En un host Linux:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up --operator=$USER

--operator=$USER permite que su usuario ejecute tailscale serve, algo que Collie necesita en el paso 4.

En un Mac, instale Tailscale desde tailscale.com/download e inicie sesión. Instale el comando tailscale desde los ajustes de la aplicación. Collie lo utiliza.

A continuación, configure la tailnet y el teléfono:

1. 01
   Abra consola de administración y seleccione Enable HTTPS. Collie lo requiere.
2. 02
   Instale la aplicación Tailscale en el teléfono. Inicie sesión con la misma cuenta.

2. Instalar Herdr

Herdr mantiene los paneles de terminal y los agentes de código en ejecución en el host al desconectarse. Collie muestra esos paneles en el teléfono.

curl -fsSL https://herdr.dev/install.sh | sh    # or: brew install herdr
herdr

Herdr abre un panel. Inicie el agente allí, por ejemplo claude. Deje Herdr en ejecución.

3. Instalar Collie

Abra un segundo terminal en el host y ejecute el script de instalación:

curl -fsSL https://colliepwa.dev/install.sh | sh

El script guarda el binario collie en ~/.local/bin. No utiliza sudo. Si la shell no encuentra collie, añada ~/.local/bin a su PATH. Independiente incluye los detalles.

4. Iniciar Collie

COLLIE_MUX=herdr collie start

start ejecuta Collie en segundo plano y lo expone en su tailnet con tailscale serve. Guarda herdr como multiplexor. Las siguientes ejecuciones solo requieren collie start. Cuando está listo, imprime Collie se está ejecutando y muestra su URL en la línea tailnet, por ejemplo https://myhost.tail1234.ts.net.

En un host Linux remoto al que se accede mediante SSH, mantenga Collie en ejecución tras cerrar la sesión:

loginctl enable-linger $USER

5. Instalar Collie en el teléfono y emparejarlo

collie qr

1. 01
   Escanee el código QR con la cámara del teléfono para abrir Collie en el navegador.
2. 02
   Añada Collie a la pantalla de inicio para que se abra a pantalla completa como una app. - iPhone: en Safari, pulse Compartir, pulse Añadir a la pantalla de inicio y pulse Añadir. - Android: en Chrome, abra Collie Settings y pulse Instalación en la tarjeta superior.
3. 03
   Abra Collie desde el nuevo icono.
4. 04
   Ejecute collie pair en el host para imprimir un código de 8 caracteres, válido durante 10 minutos.
5. 05
   En Collie, abra Ajustes → Sistema → Dispositivos emparejados.
6. 06
   Introduzca el código y un nombre, por ejemplo my phone, y pulse Emparejar este dispositivo.

Realice el emparejamiento dentro de la app de la pantalla de inicio, no en la pestaña del navegador. En un iPhone, la app de la pantalla de inicio mantiene su propio almacenamiento, independiente de Safari. Un emparejamiento realizado en Safari no se transfiere.

Una vez emparejado un dispositivo, solo los dispositivos emparejados pueden escribir en los paneles. Hasta entonces, cualquier dispositivo de su tailnet puede escribir. Empareje justo después de start. En una tailnet compartida con otras personas, configure también COLLIE_TRUSTED_USER (Configuración).

El panel de control lista sus paneles de Herdr. Los paneles que esperan entrada aparecen primero. Toque un panel para ver la salida y responder.

Pasos siguientes

• —
  Claude Code en tmux o Herdr, en el teléfono describe una jornada completa de uso con Claude Code.
• —
  Web Push añade notificaciones cuando un agente requiere interacción.
• —
  Configuración documenta cómo restringir Collie al usuario de la tailnet con COLLIE_TRUSTED_USER.
• —
  Resolución de problemas cubre los errores comunes.