ColliePWA è un client mobile per Herdr, tmux e zellij. Riproduce i riquadri degli agenti sul telefono. Consente di vedere chi è in attesa, leggere lo schermo e rispondere da qualsiasi posizione.
Herdr è il backend principale. Il supporto per tmux e zellij è sperimentale. Dettagli in Multiplexers
$ curl -fsSL https://colliepwa.dev/install.sh | shOpen source, licenza MIT. Funziona come binario self-hosted per singolo utente. Tailscale o ingress personalizzato.
Cattura statica dell'interfaccia con sessioni fittizie. L'interfaccia demo non è interattiva.
01/In breve
02/Filmato
03/Demo
Questo è il client ColliePWA di produzione. Agenti, terminali e risposte utilizzano dati mock riprodotti localmente nel browser. Nulla viene eseguito su un server e non viene inviato traffico di rete.
04/Sempre attivo
Un multiplexer mantiene in esecuzione ogni agente sulla Sua macchina anche dopo la chiusura del terminale o la perdita della connessione. ColliePWA porta questi riquadri sul Suo telefono, permettendo di controllare e rispondere da qualsiasi luogo.
Tailscale, Herdr e ColliePWA sul computer, poi sul telefono. Una guida, cinque passaggi.
05/Punto di ingresso
ColliePWA resta in ascolto solo su loopback, pertanto nulla sulla rete può raggiungerlo direttamente. Il telefono si connette attraverso un unico punto di ingresso già considerato attendibile. Scegliere quello utilizzato.
L'impostazione predefinita. collie start esegue tailscale serve automaticamente, con HTTPS sul nome tailnet. Attivare una volta i certificati HTTPS nella console di amministrazione di Tailscale.
Un hostname pubblico senza porte aperte. Inserire un login di Cloudflare Access a monte, poiché il tunnel da solo consente l'accesso all'intero traffico Internet.
Un reverse proxy con interfaccia web e Let's Encrypt. È in esecuzione in Docker, pertanto è necessario assegnare alla rete del container la modalità host per raggiungere il loopback.
Una rete mesh WireGuard, simile a una tailnet. Aggiungere un reverse proxy sull'host per HTTPS, con un certificato basato su convalida DNS per un nome privato.
Un reverse proxy che ottiene e rinnova autonomamente i certificati HTTPS. È la configurazione più rapida se si possiede un proprio dominio.
Traefik, nginx standard, ZeroTier o qualsiasi altro proxy funzionano. Devono inoltrare a 127.0.0.1 e servire HTTPS su un unico hostname fisso.
collie pair. Non utilizzare mai tailscale funnel.06/Funzionalità per funzionalità
durante l'esecuzione
ColliePWA trasmette l'output grezzo del terminale dell'agente con supporto completo ai colori ANSI, evitando trascrizioni con perdita di dati o riassunti. La visualizzazione mobile corrisponde byte per byte al terminale desktop.
quando è richiesto un input
Le richieste interattive di autorizzazione vengono visualizzate come pulsanti di azione distinti. L'input viene convalidato rispetto allo stato corrente del terminale prima dell'invio per prevenire invii non sincronizzati.
Più recenti
03Una vista Modifiche di sola lettura
Verificare le modifiche apportate da un agente prima di ritenerlo affidabile. L'elenco raggruppa i file per repository, incluso un repository membro annidato all'interno di un'area di lavoro, e un filtro consente di limitare la vista in base al percorso o allo stato (modificato, aggiunto, eliminato, rinominato, non tracciato). Toccare un file per visualizzare un diff ottimizzato per il telefono con evidenziazione della sintassi e controlli Precedente/Successivo tra i file. La vista si aggiorna ogni cinque secondi mentre è aperta e mostra l'ultimo commit del repository quando l'agente ha già eseguito il commit del proprio lavoro. Git viene eseguito con hook, filtri e rete disattivati: nessun elemento qui modifica, aggiunge all'area di staging o esegue commit.
04Conto alla rovescia della cache dei prompt
Ogni riga del dashboard e ogni intestazione di riquadro mostrano per quanto tempo la cache dei prompt di quell'agente rimane attiva. Il bridge legge il registro di sessione dell'harness, applica la durata della cache indicata dal fornitore e calcola il conto alla rovescia del tempo di inattività dall'ultima richiesta. Una nuova richiesta azzera il conteggio. I riquadri di Codex, OpenCode, pi e Claude Code riportano tutti questo valore, e una notifica Web Push opzionale avvisa prima che un riquadro monitorato scada.
05Supporto alla localizzazione
Traduzioni dell'interfaccia per inglese, tedesco, spagnolo, coreano, giapponese e cinese, configurabili in Settings. Solo gli elementi grafici dell'interfaccia utente vengono tradotti; i flussi del terminale dell'agente rimangono identici byte per byte.
06Autorizzazione esplicita del dispositivo
collie pair genera un token di otto caratteri con un TTL di dieci minuti e un limite di cinque tentativi. Il client lo scambia con un token di autenticazione il cui hash viene memorizzato dal bridge. La revoca di un dispositivo ne interrompe la richiesta successiva.
07Trascrizione dell'input vocale
Il push-to-talk trascrive direttamente nell'editor di input. Supporta API compatibili con OpenAI, istanze locali di whisper.cpp o parakeet.cpp, o credenziali Codex CLI esistenti senza chiavi separate. Richiede HTTPS tramite tailscale serve o un reverse proxy.
08Web Push al cambio di stato
Il Web Push opzionale recapita notifiche quando un agente si blocca in attesa di input o termina. La selezione di una notifica apre quell'agente. I filtri di transizione e i periodi di non disturbare sono applicati a livello di bridge su tutti i dispositivi. Richiede HTTPS e collie push-keys.
09Aree di lavoro basate su git worktree
Herdr annida i git worktree direttamente sotto il checkout del repository principale anziché creare voci di livello superiore. I worktree sono tracciati come aree di lavoro native.
10Modalità Zen
Un'impostazione opzionale che aggiunge un'opzione di attivazione al menu del riquadro per comprimere l'intera navigazione e mostrare unicamente il terminale. Mantiene un singolo pulsante mobile per uscire.
Topologia di rete
11Gateway di trasporto configurabile
ColliePWA effettua il bind esclusivamente su localhost, senza ingress pubblico. Il trasporto verso i dispositivi mobili può utilizzare la configurazione automatica di Tailscale in collie start, mesh WireGuard, tunnel o reverse proxy standard.
12Coordinamento crew multi-host
Una crew è ColliePWA su ogni macchina. Il telefono le raggiunge tutte tramite il lead. Caricamenti, giornali, registri di audit, aggiornamenti e failover sono gestiti per singola macchina, anche sotto tmux e zellij. Le macchine salvate di Herdr rimangono nella finestra di Herdr. La crew è ciò che il telefono vede.
Funzionalità aggiuntive
07/A chi è rivolto
ColliePWA è pensato per un singolo operatore con diversi agenti di programmazione in esecuzione nei riquadri del terminale su un unico host. Non sostituisce il terminale. Consente di rispondere a un agente in attesa da un telefono, per poi tornare a ciò che si stava facendo.
collie stt setup su un'origine HTTPS.collie push-keys.08/Architettura
ColliePWA scrive nelle sessioni terminale interattive con i permessi dell'utente corrente. Qualsiasi client con accesso di rete alla porta può leggere l'output del terminale ed eseguire comandi arbitrari.
Sorgente con licenza MIT. Consultare la security note per informazioni dettagliate sui controlli di accesso e sui limiti di attendibilità.
09/Installazione
ColliePWA viene eseguito accanto ai propri agenti, sulla macchina che li contiene già. Lo script scarica una release per la piattaforma in uso e la verifica. La compilazione dai sorgenti richiede git e Bun, ed è la procedura indicata per le macchine non coperte dalle release precompilate. Entrambi i metodi aggiungono collie nel PATH e nessuno dei due avvia alcun processo.
$ curl -fsSL https://colliepwa.dev/install.sh | sh
Un breve installer sh conforme a POSIX. Non richiede sudo, non avvia servizi di sistema e isola i file in ~/.local/share/collie e ~/.local/bin. Recupera l'ultima release, convalida l'hash sha256 pubblicato, scrive il binario e aggiorna il PATH. Richiede curl, tar e gli strumenti per sha256.
Servito localmente da questa origine. Il sorgente canonico si trova in scripts/install.sh nel repository. Esaminare lo script prima dell'esecuzione:
$ 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
Eseguire collie update per scaricare, verificare e passare a release più recenti. Le versioni precedenti rimangono memorizzate nella cache per collie update --rollback. Le compilazioni dai sorgenti aggiornano direttamente le revisioni git, senza destinazioni per il rollback delle release.
Generato da scripts/install.sh al commit 320bb18, 2026-10-03.
Resta un solo passaggio: avviarlo.
# 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 configurazione è facoltativa e si trova in ~/.config/collie/.env, il file creato da start. Definire qui COLLIE_TRUSTED_USER, insieme alla porta o al punto di accesso qualora le impostazioni predefinite non siano adeguate.
Accedere all'URL generato dal proprio dispositivo mobile tramite la rete locale. Aggiungere alla schermata iniziale per la modalità a schermo intero.
Richiede un ingresso privato. ColliePWA si associa esclusivamente alle interfacce di loopback. Tailscale è configurato per impostazione predefinita: collie start esegue tailscale serve sul proprio hostname MagicDNS. I reverse proxy personalizzati, le reti mesh e i tunnel SSH sono documentati nella guida alla distribuzione. Architettura solo per singolo utente.
10/FAQ
Sì. Ha licenza MIT. Non esiste alcun piano a pagamento, nessun account e nessun servizio cloud alle spalle.
Sì. La demo interattiva esegue la vera applicazione nel browser, con agenti e riquadri simulati. Non viene installato nulla e nulla viene inviato a un server.
No. ColliePWA è una web app fornita direttamente dalla propria macchina. Apra l'indirizzo sul telefono e lo aggiunga alla schermata iniziale. Su Android, Chrome propone un pulsante Installa a questo scopo. Su iPhone o iPad, usi il pannello di condivisione di Safari.
Sì. ColliePWA è un client mobile per Herdr. È una web app servita dalla propria macchina, da aprire nel browser del telefono e aggiungere alla schermata iniziale. Non c'è nulla da installare da un app store. È anche possibile accedere a Herdr tramite un'app SSH. Legga come funziona il client mobile di Herdr.
Termius e Moshi sono app di terminale disponibili su App Store o Google Play che si collegano tramite SSH. ColliePWA è una web app fornita dalla propria macchina e aperta nel browser del telefono. Mostra l'elenco degli agenti nel multiplexer, posiziona in cima quelli in attesa di risposta e include una barra Tasti con Esc, Tab, frecce e tasti modificatori, evitando che la tastiera del telefono rimanga l'unico metodo di input. Legga il confronto completo con Moshi.
Remote Control collega l'app Claude o claude.ai/code a una sessione di Claude Code sulla propria macchina, instradando il traffico attraverso le API di Anthropic. ColliePWA replica i riquadri del terminale. Funziona con qualsiasi agente eseguito al loro interno: Claude Code, Codex, OpenCode, pi e altri, in ogni riquadro della configurazione Herdr, tmux o zellij. Viene eseguito sul proprio hardware. Il telefono vi accede tramite un punto di ingresso gestito dall'utente, per impostazione predefinita Tailscale.
È possibile farlo. È così che è iniziato lo sviluppo di ColliePWA. Controllare un'interfaccia a riga di comando tramite controlli su schermo è poco pratico: i tasti speciali sono scomodi, Ctrl, Esc e le frecce richiedono combinazioni complesse e l'inserimento di testo normale entra in conflitto con la tastiera virtuale. ColliePWA consente di toccare l'agente in attesa di risposta, digitare normalmente e premere Esc o Ctrl+C con un solo pollice.
Con qualsiasi agente eseguito in un riquadro di terminale. ColliePWA replica il riquadro stesso, quindi non richiede un'API fornita dall'agente. Il timer per la cache del prompt presente su ciascun riquadro riconosce Claude Code, Codex, OpenCode e pi.
Herdr, tmux o zellij. Herdr è il backend principale. tmux e zellij funzionano, ma sono sperimentali. collie start rileva quelli presenti nel sistema e richiede quale replicare.
L'host esegue Linux o macOS. Su Windows, il bridge funziona con la beta per Windows di Herdr, e tale supporto è sperimentale. Sul telefono funziona qualsiasi browser recente.
No. Tailscale è l'opzione predefinita, poiché collie start lo configura in modo automatico. È possibile utilizzare anche un reverse proxy, Cloudflare Tunnel, NetBird o un'altra rete mesh. La guida all'implementazione li illustra ciascuno.
Le notifiche Web Push richiedono due requisiti: un indirizzo HTTPS e una coppia di chiavi generata con collie push-keys. Con una connessione HTTP standard, il browser non consente le notifiche push e l'interruttore rimane disattivato. Su iPhone, occorre prima aggiungere ColliePWA alla schermata iniziale. Safari consente le notifiche push solo per le web app salvate sulla schermata iniziale.
ColliePWA fornisce un accesso shell remoto alla propria macchina. È concepito esattamente per questo. Chiunque raggiunga l'indirizzo può leggere i riquadri e inviare comandi. Il servizio rimane in ascolto solo sull'interfaccia di loopback, pertanto è necessario mantenere un solo punto di ingresso privato ed eseguire l'associazione del telefono con collie pair. Non deve mai essere reso pubblico tramite tailscale funnel. Legga la nota sulla sicurezza prima di eseguirlo.
Nessuna telemetria, nessuna analisi statistica e nessuna segnalazione di arresto anomalo. L'unica chiamata eseguita in modo autonomo è un controllo anonimo degli aggiornamenti tramite i tag pubblici di GitHub. L'invio delle notifiche push avviene tramite il servizio di notifica del browser, ed esclusivamente dopo la loro attivazione. L'input vocale ricorre a un servizio cloud solo qualora venga selezionato rispetto a un motore locale.
No. ColliePWA è destinato a un unico operatore. Non include account utente né permessi individuali. Se si eseguono agenti su più macchine, una crew consente di raggrupparli tutti dietro un unico indirizzo, a uso esclusivo dell'utente.
Toccare Aggiorna nelle Impostazioni del telefono, oppure eseguire collie update sull'host. Le versioni precedenti rimangono su disco, quindi collie update --rollback consente di ripristinarle.