ColliePWA

ColliePWA is an open-source (MIT) web app for your phone. It displays your terminal AI agents, including Claude Code, Codex and OpenCode, and lets you answer them remotely. You host it on your own computer alongside Herdr. Support for the new Herdr core, tmux and zellij is experimental. ColliePWA is served over Tailscale, so only devices on your own tailnet reach it. You install it via your browser directly to your home screen, bypassing app stores.

Using Herdr? Read about the Herdr mobile client.

What you can do

• Answer what needs you. The dashboard surfaces waiting agents first. Agent prompts turn into buttons. Quick replies, a configurable keys board, and your system keyboard with voice dictation handle input. Guide
• WalkyTalky: agents message each other, and you message them. Send short messages between agent sessions across programs and machines. Message any session from your phone. Every message returns a receipt. WalkyTalky
• Start agents from the phone. Use the + New page to choose the machine, agent or command, directory, and an optional git worktree. Guide
• Push notifications and voice input. Receive alerts when an agent pauses or finishes. Whistle, Collie's built-in speech engine, converts voice to text. It remains inactive until configured. Voice and push
• See what the agent changed. The Files view displays the workspace folder, marks modified files, and provides a read-only view of git diffs and the latest commit. Changes
• Crews. Cluster multiple Collie hosts behind one URL with manual failover. Crews
• Tricks, and the Hill. Add small programs that put counts, marks and screens in Collie. Let an agent or a trick ask you one question, and answer it with one tap. Tricks, The Hill

Other features: output search, full conversation history, image and file attachments, durable agents (experimental), four themes, twelve languages, and per-device typeface selection. The Edge release line typesets chat equations when math is enabled (syntax). Edge receives features before Stable (Manage & update).

Get it on your phone in 3 steps

Prerequisites: Tailscale on your computer and phone, and Herdr (or experimental Herdr core, tmux, or zellij) running on your computer. For new setups, follow Install in five minutes for platform-specific instructions, including Windows. Alternative options (Arch, Nix, Herdr plugin, source) are in Install.

1. Install on your computer. Requires curl, tar, and a sha256 utility. Needs no sudo or compiler. Verifies checksums automatically:

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

2. Start it on your tailnet:

COLLIE_MUX=herdr collie start          # or: herdr-core, tmux, zellij

Without COLLIE_MUX, collie start checks for Herdr, tmux, and zellij and prompts you to pick one. It offers Herdr core only if the Herdr TUI is absent.

3. Put it on your phone and pair it. Run collie qr and scan the code. Add ColliePWA to your home screen:

• iPhone: In Safari, tap Share (under ⋯ in the default iOS 26 layout), tap Add to Home Screen, then tap Add.
• Android: In Chrome, open Collie Settings and tap Install on the top card.

ColliePWA is not on the App Store or Google Play; home-screen installation is required. Launch the installed app, run collie pair on your computer, and enter the code under Settings → System → Paired devices. Pair within the home-screen app, not the browser: iOS keeps their storage separate. The app displays no panes until paired.

Agents awaiting input appear first. Tap an agent to reply. To configure Collie using an agent, instruct it to run collie skill and follow the instructions.

Collie exposes remote shell access to your machine. Keep it on your tailnet (tailscale serve, never funnel). Read Security before running.

Security, read this first

Collie provides remote shell access to your machine by design. A single Collie API call sends arbitrary keystrokes directly into a live terminal pane. Anyone with access to the URL can read pane output (source code, secrets, environment variables, agent output) and execute arbitrary commands with your full user privileges. There is no sandbox and no command allow-list, as these would defeat the core workflow. Treat the URL as a root login: bind it strictly to your tailnet, set COLLIE_TRUSTED_USER, and pair only the physical phone you are using. Read docs/security.md for details on the security model, defense layers, and device gating before running the service.

Never tailscale funnel this. funnel exposes the port to the public internet, whereas serve limits access to your private tailnet. Do not funnel Collie under any circumstances.

Who this is for

Collie is for developers running terminal-multiplexed AI agents who want phone access via a touch UI instead of an emulated terminal. Herdr is the primary target. The Herdr core, tmux and zellij are experimental: they function, but testing is limited. Bug reports are welcome, including reports of working setups.

This is the beginning of the README. Read the rest at the original. Read the full README ↗