während der Ausführung
Echtes Terminal-Mirroring
Keine Zusammenfassung, kein einfaches Log. ColliePWA zeigt die exakte Terminalausgabe inklusive ANSI-Farben, identisch zur Ansicht auf dem Host.
Verwalte deine Coding-Agenten mobil.
ColliePWA verbindet dein Smartphone mit dem lokalen Terminal-Multiplexer. Autonome Agenten laufen stundenlang in Panes und stoppen für Rückfragen. ColliePWA zeigt aktive Sessions, signalisiert wartende Prozesse und erlaubt direkte Eingaben vom Telefon.
- Multiplexer-Anbindung:
- Herdr
- tmux
- Zellij
Herdr wird in Version 1.0 vollständig unterstützt. Tmux und Zellij funktionieren experimentell. Details in Multiplexer
Live-Ansicht von ColliePWA mit Beispiel-Agenten. Keine aktive Backend-Verbindung im Vorschaumodus.
01/Demo
Direkt im Browser testen
Das ist die echte Oberfläche von ColliePWA mit Mock-Daten. Agenten, Terminals und Antworten laufen lokal im Browser. Es werden keine Befehle ausgeführt oder Daten übertragen.
- 01Den obersten Agenten mit dem Status blocked auswählen.
- 02Die Eingabeaufforderung lesen. Das Terminal wird exakt gespiegelt.
- 03Eine Antwort antippen und den weiteren Ablauf beobachten.
- 04Auf Keys tippen für Tasten wie Esc, Tab, Pfeiltasten und Ctrl.
02/Funktionsumfang
Zwei Kernfunktionen und die Neuerungen in 1.0
bei Blockaden
Antworten per Fingertipp
Berechtigungsabfragen erscheinen als Buttons. Eingaben werden vor dem Senden gegen den aktuellen Bildschirminhalt validiert, um Fehlbedienungen auszuschließen.
Neu in Version 1.0
03Sechs Sprachen
Englisch, Deutsch, Spanisch, Koreanisch, Japanisch und Chinesisch in den Einstellungen. Nur die UI-Texte werden übersetzt; Terminalausgaben der Agenten bleiben unverändert.
04Gerätekopplung mit Freigabe
collie pair erzeugt einen achtstelligen Code, gültig für zehn Minuten und fünf Versuche. Das Mobilgerät tauscht ihn gegen ein Einmal-Token; die Bridge speichert nur dessen Hash. Widerrufene Geräte werden beim nächsten Request abgewiesen.
05Spracheingabe
Halten zum Aufnehmen, ColliePWA fügt das Transkript in das Eingabefeld ein. Unterstützt jeden OpenAI-kompatiblen Endpunkt wie lokale Instanzen von whisper.cpp oder parakeet.cpp sowie vorhandene Logins der Codex CLI. Erfordert HTTPS, beispielsweise über tailscale serve.
06Web-Push bei Statuswechsel
Optionaler Web-Push benachrichtigt, sobald ein Agent auf Eingaben wartet oder fertiggestellt ist. Ein Klick öffnet den jeweiligen Agenten. Benachrichtigungsfilter und Ruhezeiten gelten bridge-weit für alle Geräte. Erfordert HTTPS und collie push-keys.
07Git Worktrees als Spaces
In Herdr: Das Öffnen eines Git Worktrees ordnet den Space hierarchisch unter dem Haupt-Checkout ein. Die Verwaltung übernimmt Herdr direkt.
08Zen-Modus
Gerätespezifische Option im Pane-Menü, die alle Bedienelemente außer dem Terminal ausblendet. Standardmäßig deaktiviert; die Rückkehr erfolgt über einen schwebenden Button.
Netzwerkzugriff
09Flexible Zugriffspfade
ColliePWA bindet an Loopback und exponiert keine Ports ins Internet. Der Transport zum Telefon erfolgt über Tailscale mittels collie start, alternative Mesh-Netzwerke, SSH-Tunnel oder eigene Reverse-Proxies.
10Zentraler Einstieg für mehrere Hosts
Ein Pack ist ColliePWA auf jedem Rechner. Das Telefon erreicht alle über den Lead. Uploads, Journal, Audit-Log, Updates und Failover laufen pro Rechner, auch unter tmux und zellij. Herdrs gespeicherte Rechner bleiben im Herdr-Fenster. Das Pack ist das, was das Telefon sieht.
Weitere Details
- 11Statusübersicht aller Instanzen
- Gruppierung der Agenten nach erforderlicher Benutzeraktion. Blockierte Instanzen stehen oben.
- 12Vollständiger Scrollback-Puffer
- ColliePWA liest das Transkript des Agenten direkt aus, sodass der gesamte Verlauf statt nur des sichtbaren Ausschnitts verfügbar ist.
- 13Mehrere Sessions pro Instanz
- In Herdr lassen sich alle benannten Sessions der Konfiguration über den Header umschalten, ohne Anpassungen am Host vorzunehmen.
03/Zielgruppe
Für Entwickler, die Agenten im Multiplexer laufen lassen und den Schreibtisch verlassen.
ColliePWA ist für einzelne Nutzer gedacht, die mehrere Coding-Agenten in Terminal-Panes auf einem Host betreiben. Es ersetzt nicht das Terminal. Es erlaubt dir, einem wartenden Agenten vom Smartphone aus zu antworten und direkt weiterzumachen.
- Setzt auf deinen bestehenden Workflow auf
- Verbindet sich direkt mit deinem vorhandenen Multiplexer: Herdr, tmux oder zellij. Kein neues Session-Modell, kein Wrapper um den Agenten. Herdr wird in 1.0 voll unterstützt. tmux und zellij sind experimentell.
- Kein App Store, keine Cloud, kein Account
- Eine PWA, die direkt von deinem Rechner über dein Tailnet ausgeliefert wird. Kein Store-Eintrag, kein Anbieter-Account, keine Cloud-Infrastruktur. Externe Dienste existieren nur, wenn du sie aktivierst: der Browser-Push-Dienst und ein Cloud-Transkriptions-Endpunkt, falls du keine lokale Engine nutzt. Zum Home-Bildschirm hinzufügen und wie eine native App nutzen.
- Gebaut für die fehlende Tastatur
- Sondertasten, Pfeile und Modifier liegen auf einem Keypad. Für eigene Schnellantworten und Slash-Befehle genügt ein Fingertipp. Das Eingabefeld ist reiner Text, daher funktioniert die Smartphone-Diktierfunktion direkt. Integrierte Spracheingabe steht bereit, sobald du
collie stt setupauf einem HTTPS-Origin ausführst. - Benachrichtigung bei Rückfragen
- Optionales Web Push informiert dich, sobald ein Agent auf Eingabe wartet oder fertig ist. Ein Tippen auf die Nachricht öffnet die passende Pane. Erfordert HTTPS und
collie push-keys. - Mehrere Rechner, eine URL
- Ein Pack bündelt alle Hosts hinter einer Adresse, inklusive vorab autorisiertem Failover direkt aus dem Browser. Eine einzige Bestätigung aktualisiert das gesamte Pack im selben Screen.
- MIT-Lizenz. Mach mit.
- Der Quellcode liegt auf GitHub unter der MIT-Lizenz. Fehlerberichte zu Setups mit tmux und zellij sind willkommen, ebenso Berichte über funktionierende Konfigurationen.
04/Architektur
Direkter Shell-Zugriff auf deiner eigenen Hardware.
ColliePWA sendet Tastatureingaben direkt an eine interaktive Shell mit den Rechten deines Nutzers. Jeder mit Netzwerkzugriff auf die Instanz kann Panes einsehen und Befehle ausführen. Aus diesem Grund existiert kein zentrales Hosting.
- Lokale Ausführung neben den Agenten
- ColliePWA läuft auf demselben Host wie der Multiplexer. Herdr wird in Version 1.0 voll unterstützt; Tmux und Zellij gelten als experimentell. Es gibt keine externen Server, keine Cloud-Dienste und keine Accounts.
- Loopback-Bindung und Zugriffskontrolle
- Dienste binden ausschließlich an 127.0.0.1 statt 0.0.0.0. Die Freigabe erfolgt kontrolliert über Tailscale Serve oder einen manuell konfigurierten Reverse-Proxy. Tailscale Funnel wird nicht unterstützt.
- Geräte- statt Nutzerauthentifizierung
- Die Zugriffskontrolle validiert das anfragende Gerät im Netzwerk, nicht die Person. Ohne zusätzliche Passwortabfrage gewährt ein entsperrtes Telefon direkten Shell-Zugriff.
- Sicherheit auf Multi-User-Systemen
- Multiplexer-Sockets sind dateibasiert und über Unix-Dateirechte geschützt. Der TCP-Port von ColliePWA ist auf dem Host lokal für andere Benutzer erreichbar. Beschränke den Zugriff über die Firewall deines Ingress-Proxies oder via COLLIE_TRUSTED_USER unter Tailscale.
Open Source unter MIT-Lizenz. Lies die Sicherheitshinweise vor dem produktiven Einsatz.
05/Installation
Per Skript installieren oder aus dem Quellcode bauen.
ColliePWA läuft direkt auf dem Host deiner Agenten. Das Installationsskript lädt das passende Release herunter und validiert die Checksumme. Für nicht offiziell unterstützte Plattformen ist der Build via Git und Bun vorgesehen. Beide Wege legen die Binary im PATH ab, starten aber keine Prozesse im Hintergrund.
$ curl -fsSL https://colliepwa.dev/install.sh | sh
Kompaktes POSIX-sh-Skript. Es verlangt kein sudo, registriert keine Daemons und schreibt ausschließlich nach ~/.local/share/collie sowie ~/.local/bin. Es lädt das Release für deine Architektur, verifiziert den sha256-Hash, verlinkt das Binary in den PATH und listet die nächsten Schritte auf. Voraussetzungen sind lediglich curl, tar und ein SHA256-Tool.
Diese URL spiegelt das Skript. Die kanonische Version liegt unter scripts/install.sh im Repository. Prüfe den Inhalt vor der Ausführung:
$ 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
Der Befehl collie update lädt künftige Releases über dieselbe Routine, validiert sie und startet die Instanz neu. Vorherige Versionen verbleiben auf der Festplatte, sodass collie update --rollback jederzeit möglich ist. Dies gilt nur für Binärinstallationen; Builds aus dem Quellcode aktualisieren direkt den Git-Checkout.
Stand: scripts/install.sh bei 2ded11d (2026-08-31).
Letzter Schritt: Starten.
# 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
Die Konfiguration ist optional und liegt in ~/.config/collie/.env, die beim Ausführen von start angelegt wird. Passe dort COLLIE_TRUSTED_USER an, ebenso wie Port oder Einstiegspunkt, falls die Standardwerte nicht passen.
Öffne die ausgegebene URL im Browser deines Telefons innerhalb desselben Netzwerks. Als PWA zum Homescreen hinzugefügt verhält sich die Oberfläche wie eine native App.
Sicherer Fernzugriff erforderlich: ColliePWA bindet ausschließlich an Loopback-Interfaces. Tailscale ist der Standardpfad: collie start führt tailscale serve aus und stellt einen MagicDNS-Namen bereit. Alternative Setups mit Reverse-Proxies oder VPN-Tunneln sind in DEPLOYMENT.md dokumentiert. Das System ist strikt für einen einzelnen Benutzer ausgelegt und bietet keine Mehrbenutzerverwaltung.