Direkt zum Inhalt
ColliePWA

01/Documentation

In fünf Minuten installieren

Die empfohlene Konfiguration, Schritt für Schritt: Tailscale, Herdr und Collie auf Ihrem Computer, dann ein gekoppeltes Telefon mit Collie auf dem Startbildschirm

Diese Anleitung richtet Collie auf Ihrem Telefon ein. Installieren Sie drei Werkzeuge auf Ihrem Computer, starten Sie Collie und koppeln Sie Ihr Telefon.

Sie verwendet die empfohlene Konfiguration: Tailscale als Zugangspunkt, Herdr als Multiplexer und das Installationsskript. Für andere Konfigurationen siehe Installation.

Hinweis. Collie gewährt konstruktionsbedingt Fernzugriff per Shell auf Ihren Rechner. Lesen Sie Sicherheit, bevor Sie es installieren.

Was Sie benötigen

  • Ein Linux- oder macOS-Computer (der Host). Ein Mac benötigt Apple Silicon und macOS 13 oder neuer.
  • Ein iPhone oder ein Android-Smartphone.
  • Ein Tailscale-Konto.

1. Tailscale installieren

Tailscale verbindet den Host und Ihr Telefon in einem privaten Netzwerk, Ihrem Tailnet. Collie ist nur in diesem Netzwerk erreichbar.

Auf einem Linux-Host:

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

--operator=$USER erlaubt Ihrem Benutzer das Ausführen von tailscale serve, was Collie in Schritt 4 benötigt.

Installieren Sie Tailscale auf einem Mac von tailscale.com/download und melden Sie sich an. Installieren Sie den Befehl tailscale über die App-Einstellungen. Collie ruft ihn auf.

Als Nächstes richten Sie das Tailnet und das Telefon ein:

  1. Öffnen Sie die Admin-Konsole und wählen Sie HTTPS aktivieren aus. Collie setzt dies voraus.
  2. Installieren Sie die Tailscale-App auf Ihrem Telefon. Melden Sie sich mit demselben Konto an.

2. Herdr installieren

Herdr hält Terminal-Bereiche und Coding-Agenten auf dem Host aktiv, wenn Sie die Verbindung trennen. Collie zeigt diese Bereiche auf Ihrem Telefon an.

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

Herdr öffnet einen Bereich. Starten Sie Ihren Agenten dort, zum Beispiel claude. Lassen Sie Herdr laufen.

3. Collie installieren

Öffnen Sie ein zweites Terminal auf dem Host und führen Sie das Installationsskript aus:

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

Das Skript speichert die Binärdatei collie unter ~/.local/bin. Es verwendet kein sudo. Wenn Ihre Shell collie nicht finden kann, fügen Sie ~/.local/bin zu Ihrem PATH hinzu. Eigenständig beschreibt die Einzelheiten.

4. Collie starten

COLLIE_MUX=herdr collie start

start führt Collie im Hintergrund aus und gibt es in Ihrem Tailnet über tailscale serve frei. Es speichert herdr als Multiplexer. Zukünftige Ausführungen benötigen nur collie start. Sobald betriebsbereit, gibt es Collie läuft aus und zeigt Ihre URL in der Zeile tailnet an, zum Beispiel https://myhost.tail1234.ts.net.

Auf einem entfernten Linux-Host, der per SSH erreicht wird, lassen Sie Collie nach der Abmeldung weiterlaufen:

loginctl enable-linger $USER

5. Collie auf Ihrem Telefon einrichten und koppeln

collie qr
  1. Scannen Sie den QR-Code mit Ihrer Telefonkamera, um Collie im Browser zu öffnen.
  2. Fügen Sie Collie zu Ihrem Startbildschirm hinzu, damit es sich im Vollbildmodus wie eine App öffnet. - iPhone: in Safari tippen Sie auf Teilen, auf Zum Home-Bildschirm und auf Hinzufügen. - Android: in Chrome öffnen Sie Collie Einstellungen und tippen Sie auf der obersten Karte auf Installation.
  3. Öffnen Sie Collie über das neue Symbol.
  4. Führen Sie collie pair auf dem Host aus, um einen für 10 Minuten gültigen, 8-stelligen Code auszugeben.
  5. Öffnen Sie in Collie Einstellungen → System → Gekoppelte Geräte.
  6. Geben Sie den Code und einen Namen ein, beispielsweise my phone, und tippen Sie auf Dieses Gerät koppeln.

Koppeln Sie innerhalb der Startbildschirm-App, nicht im Browser-Tab. Auf einem iPhone verwendet die Startbildschirm-App einen eigenen Speicher, getrennt von Safari. Eine in Safari durchgeführte Kopplung wird nicht übertragen.

Sobald ein Gerät gekoppelt ist, können nur noch gekoppelte Geräte Eingaben in Ihre Bereiche vornehmen. Bis dahin kann jedes Gerät in Ihrem Tailnet Eingaben tätigen. Koppeln Sie direkt nach start. Setzen Sie in einem mit anderen Personen geteilten Tailnet zusätzlich COLLIE_TRUSTED_USER (Konfiguration).

Das Dashboard listet Ihre Herdr-Bereiche auf. Bereiche, die auf Eingaben warten, stehen an erster Stelle. Tippen Sie auf einen Bereich, um Ausgaben anzuzeigen und zu antworten.

Nächste Schritte

Diese Seite auf GitHub bearbeiten

The rest of the documentation