Installer en cinq minutes

Ce guide configure Collie sur votre téléphone. Installez trois outils sur votre ordinateur, démarrez Collie et associez votre téléphone.

Il utilise la configuration recommandée : Tailscale comme point d'entrée, Herdr comme multiplexeur et le script d'installation. Pour d'autres configurations, consultez Installer.

Remarque. Collie donne un accès shell distant à votre machine de par sa conception. Lisez Sécurité avant de l'installer.

Prérequis

• —
  Un ordinateur Linux ou macOS (l'hôte). Un Mac nécessite Apple Silicon et macOS 13 ou supérieur.
• —
  Un téléphone iPhone ou Android.
• —
  Un compte Tailscale.

1. Installer Tailscale

Tailscale relie l'hôte et votre téléphone sur un même réseau privé, votre tailnet. Collie n'est accessible que sur ce réseau.

Sur un hôte Linux :

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

--operator=$USER permet à votre utilisateur d'exécuter tailscale serve, ce dont Collie a besoin à l'étape 4.

Sur un Mac, installez Tailscale depuis tailscale.com/download et connectez-vous. Installez la commande tailscale depuis les paramètres de l'application. Collie l'appelle.

Ensuite, configurez le tailnet et le téléphone :

1. 01
   Ouvrez la console d'administration et sélectionnez Activer HTTPS. Collie le requiert.
2. 02
   Installez l'application Tailscale sur votre téléphone. Connectez-vous avec le même compte.

2. Installer Herdr

Herdr maintient les panneaux de terminal et les agents de code en cours d'exécution sur l'hôte lorsque vous vous déconnectez. Collie affiche ces panneaux sur votre téléphone.

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

Herdr ouvre un panneau. Démarrez votre agent dedans, par exemple claude. Laissez Herdr tourner.

3. Installer Collie

Ouvrez un second terminal sur l'hôte et exécutez le script d'installation :

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

Le script enregistre le binaire collie dans ~/.local/bin. Il n'utilise pas sudo. Si votre shell ne trouve pas collie, ajoutez ~/.local/bin à votre PATH. Autonome détaille cette étape.

4. Démarrer Collie

COLLIE_MUX=herdr collie start

start exécute Collie en arrière-plan et l'expose sur votre tailnet avec tailscale serve. Il enregistre herdr comme multiplexeur. Les prochains démarrages nécessitent seulement collie start. Une fois prêt, il affiche Collie est en cours d'exécution et indique votre URL sur la ligne tailnet, par exemple https://myhost.tail1234.ts.net.

Sur un hôte Linux distant accessible par SSH, maintenez Collie en cours d'exécution après la déconnexion :

loginctl enable-linger $USER

5. Installer Collie sur votre téléphone et l'associer

collie qr

1. 01
   Scannez le code QR avec l'appareil photo de votre téléphone pour ouvrir Collie dans le navigateur.
2. 02
   Ajoutez Collie à votre écran d'accueil pour qu'il s'ouvre en plein écran comme une application. - iPhone : dans Safari, appuyez sur Partager, sur Sur l'écran d'accueil, puis sur Ajouter. - Android : dans Chrome, ouvrez Collie Paramètres et appuyez sur Installer sur la carte du haut.
3. 03
   Ouvrez Collie depuis la nouvelle icône.
4. 04
   Exécutez collie pair sur l'hôte pour afficher un code à 8 caractères, valide pendant 10 minutes.
5. 05
   Dans Collie, ouvrez Paramètres → Système → Appareils associés.
6. 06
   Saisissez le code ainsi qu'un nom, par exemple my phone, puis appuyez sur Associer cet appareil.

Effectuez l'association depuis l'application de l'écran d'accueil, pas dans l'onglet du navigateur. Sur un iPhone, l'application de l'écran d'accueil dispose de son propre stockage, distinct de Safari. Une association réalisée dans Safari n'est pas conservée.

Dès qu'un appareil est associé, seuls les appareils associés peuvent écrire dans vos panneaux. D'ici là, n'importe quel appareil de votre tailnet peut écrire. Associez votre appareil juste après start. Sur un tailnet partagé avec d'autres personnes, définissez aussi COLLIE_TRUSTED_USER (Configurer).

Le tableau de bord liste vos panneaux Herdr. Les panneaux en attente de saisie apparaissent en premier. Appuyez sur un panneau pour afficher la sortie et répondre.

Étapes suivantes

• —
  Claude Code dans tmux ou Herdr, sur votre téléphone détaille une journée complète d'utilisation avec Claude Code.
• —
  Web Push ajoute des notifications lorsqu'un agent requiert une saisie.
• —
  Configurer explique comment restreindre Collie à votre utilisateur tailnet avec COLLIE_TRUSTED_USER.
• —
  Dépannage traite les erreurs courantes.