ColliePWA

ColliePWA is a self-hosted mobile interface for developers who run coding agents inside terminal multiplexers. It doesn't replace the terminal or move agents into a vendor cloud. Instead, a small binary runs on the same machine as the existing sessions, lists the active agent panes, shows which ones are working or waiting, and lets the operator respond from a phone. The interface is a progressive web app, so it can be added to a mobile home screen without an app store account. The project is built for a specific workflow in which several terminal agents can continue independently until one needs a permission decision, an answer, or another piece of keyboard input.

The dashboard groups agent processes by state and puts blocked sessions first. Selecting a pane opens its raw terminal stream with ANSI color rather than a rewritten summary. That detail matters when the exact command output, prompt, or failure context determines the right response. Permission prompts can appear as discrete action buttons, and ColliePWA checks current terminal state before sending a response to reduce the chance of acting on stale output. A mobile keypad exposes keys that are awkward on a phone, including Escape, Tab, arrows, Control combinations, and navigation controls. Users can also define quick replies and slash commands or use the ordinary text composer with the phone's built-in dictation.

Herdr is the primary supported multiplexer backend in version 1.0. Experimental drivers are available for tmux and Zellij, which expands the audience but comes with less certainty than the Herdr path. ColliePWA retains complete scrollback beyond the visible terminal viewport and can expose multiple sessions through one gateway. Optional Zen mode removes most navigation when someone wants to concentrate on a single terminal. For developers working across several hosts, a crew can put the ColliePWA instance from each machine behind one address. The topology includes a lead, authorized failover, per-machine journals and audit logs, and a phone view that can reach the connected hosts.

The software runs locally and binds strictly to the loopback interface. Remote access therefore needs a private ingress route rather than an open listener. The default startup path configures Tailscale Serve on the host's MagicDNS name, while documented alternatives include WireGuard meshes, reverse proxies, tunnels, and custom ingress. Device pairing uses an eight-character token with a ten-minute lifetime and a five-attempt limit. A paired device receives an authentication token whose hash is stored by the bridge, and revoking the device invalidates its next request. The project is explicit that anyone with authorized access can read terminal output and execute commands with the current user's permissions, so the network boundary and device trust model need to be treated as shell access.

Optional Web Push notifications can alert the operator when an agent becomes blocked or finishes. Tapping a notification opens the relevant pane, and bridge-wide transition filters and quiet periods can control which state changes interrupt the user. Voice input is also optional. Push-to-talk transcription can use OpenAI-compatible APIs, a local whisper.cpp or parakeet.cpp instance, or existing Codex CLI credentials. Both push and built-in voice features require an HTTPS origin. These additions suit the mobile use case, but they're opt-in and don't change the core local execution model. Terminal data stays on the operator's host unless an enabled outside service, such as browser push or a cloud transcription endpoint, receives the information needed for that feature.

Installation is available through a POSIX shell script or a source build. The installer downloads a platform release, checks the published SHA-256 hash, avoids sudo, starts no system services, and places files under the user's local data and binary directories. After installation, running collie start asks which multiplexer to mirror and writes an optional configuration file. Source builds require Git and Bun. The update command downloads and verifies newer releases, while release installations retain previous versions for rollback. This is a technical setup, but the project documents where files go, what the installer does, and how to inspect its source before running it.

ColliePWA is open source under the MIT license and has no cloud plan, account system, or app store distribution. Its best audience is one operator running multiple coding agents across terminal panes and wanting freedom to step away from the desk without missing a blocked prompt. It isn't a general remote desktop, a hosted agent service, or a multi-user collaboration layer. Herdr users get the clearest supported path, while tmux and Zellij users should expect experimental edges. The focused architecture keeps the product close to an existing terminal workflow, but it also asks the operator to be comfortable securing private ingress and granting a phone the equivalent of interactive shell authority.