ColliePWA is a mobile client for Herdr, tmux and zellij. It puts your agent panes on your phone. See who is waiting, read the chat or the screen, and reply from anywhere.
Herdr is the primary backend. tmux and zellij support is experimental. Details in Terminals
$ curl -fsSL https://colliepwa.dev/install.sh | shOpen source, MIT license. Runs as a self-hosted single-user binary. Tailscale or custom ingress.
Static interface capture with mock sessions. The demo interface is non-interactive.
In short
See it
This is the production ColliePWA client. Agents, terminals, and responses use mock data replayed locally in your browser. Nothing runs on a server and no network traffic is sent.
Read and answer
while it works
Chat shows the agent's session, turn by turn: your messages, its replies and its thinking behind a fold, with each tool call folded into one line. It is the default view of an agent pane. If the bridge drops, the phone shows a read-only copy of recent turns.
on input required
Interactive permission prompts render as discrete action buttons. Input is validated against current terminal state before dispatch to prevent desynced submissions.
when you want the raw screen
The terminal view shows the pane byte for byte, with ANSI color. Tap Screen below the reply box to open it, and tap again to return to Chat. You can set it as default in the pane menu.
Each machine saves the shell lines you send through ColliePWA. The strip above the box offers them again on shell panes. Lines that start with a space are not saved, and neither are lines that look like secrets. Agent prompts are never saved. The Suggestions from Sent switch in Settings, Device, turns the strip off on shell panes. COLLIE_SENT=off saves nothing on the machine.
Type / in an agent pane, or $ for Codex skills. The strip lists matching commands. A tap fills the box without sending.
In Claude Code panes, the Agent palette also lists skills and commands from your ~/.claude and project .claude folders. It also lists the skills and commands of installed plugins, with their plugin: prefix. It omits disabled plugins. Tap an item to fill the box without sending.
Optional Web Push delivers notifications when an agent blocks on input or finishes. Selecting a notification opens that agent. Transition filters and do-not-disturb periods are bridge-wide across every device. Requires HTTPS and collie push-keys.
The + New button on the dashboard opens the New page. In a crew, select the machine first, choose Agent or Shell, then tap Start. Uninstalled agents appear greyed out with the reason in brackets. Under the Folder field, a Browse row steps through your home folder one level per tap. It marks each folder that is a repository. On Herdr, New worktree puts a new branch in its own folder. Every start uses an id, so dropped replies never create duplicate panes.
See what an agent changed before you trust it. Files marks altered files in the workspace. Changes groups them by repository, filtered by path or status. Tap a file to view a mobile-friendly diff, or preview Markdown, JSON, HTML and images. The view is read-only: git runs without hooks, filters or network access, and nothing edits, stages or commits.
Themes
ColliePWA ships with four themes: Collie, Nightwatch, Daylight and Harbour. A theme carries colours, type, shape, look and a terminal palette. Every value is a closed word or a checked colour, and every theme has a light half and a dark half.
Collie
Typeface: Aldrich
The look you know: neutral greys, with Aldrich for the type.
Nightwatch
Typeface: IBM Plex Sans
flat · bold · strong · band · heavy
For the phone on call at night. A true black dark half, flat and square, with heavy lines, a dim amber accent and a dim amber band behind the header and the bars.
Terminal palette
Daylight
Typeface: Geist
Titles: Atkinson Hyperlegible Next
round · lifted · roomy · gradient · cards · sentence
For bright sun and low vision. Body text at AAA contrast, round roomy cards, a page that shifts toward the foot, and status colours that run from blue to orange, not from red to green.
Terminal palette
Harbour
Typeface: Atkinson Hyperlegible Next
Titles: Space Grotesk
soft · lifted · grain · thin
For people who come from the terminal. Cool blue-grey with one teal accent, soft corners, a fine grain and thin icons, and a Solarized-based terminal palette on a near-black blue.
Terminal palette
Reach
A multiplexer keeps every agent running on your machine after you close the terminal or lose connection. ColliePWA puts those panes on your phone so you can check in and answer from anywhere.
Tailscale, Herdr and ColliePWA on your computer, then your phone. One guide, five steps.
ColliePWA listens only on loopback, so nothing on the network reaches it directly. Your phone comes in through one front door that you already trust. Pick the one you run.
The default. collie start runs tailscale serve for you, with HTTPS on your tailnet name. Turn on HTTPS certificates in the Tailscale admin console once.
A public hostname without an open port. Put a Cloudflare Access login in front of it, because the tunnel alone lets the whole internet in.
A reverse proxy with a web UI and Let's Encrypt. It runs in Docker, so give the container host networking to reach loopback.
A WireGuard mesh, like a tailnet. Add a reverse proxy on the host for HTTPS, with a DNS challenge certificate for a private name.
A reverse proxy that gets and renews HTTPS certificates on its own. It is the shortest setup if you have your own domain.
Traefik, plain nginx, ZeroTier or any other proxy works. It must forward to 127.0.0.1 and serve HTTPS on one fixed hostname.
ColliePWA writes to your interactive terminal sessions with your current user permissions. A client that holds a pairing token can read terminal output and execute arbitrary commands.
MIT licensed source. Review the security note for detailed access controls and trust boundaries.
Crew
A crew runs ColliePWA on every machine. Your phone connects to all of them through the lead. A deputy you named can take over if the lead fails. The Machines screen charts CPU, memory, disks and network use over the last 24 hours.
One agent session sends a short signed message to another, in any coding agent across your crew. You can message any session from your phone too. It is on by default. COLLIE_WALKY=off turns it off for one machine.
collie skill sync. Run collie skill uninstall to remove it from one agent.collie walky who
collie walky send desk/w1:p2#k3f9 "Tests are green on fix-465. You can merge."[walky-talky wt_k3f9x2m8q1a0] from agent laptop/w2:p1 (claude, collie#fix-465): a message from another agent, not your operator. Read it: collie walky inbox wt_k3f9x2m8q1a0. Reply: collie walky reply wt_k3f9x2m8q1a0 "<text>"
The commands, the inbox, and how signing works.
More
Durable agents
Built a long-running agent with Pi Durable or your own code? ColliePWA gives it approval prompts, history and a chat view, with no UI code of your own.
Experimental: the wire may change in any minor.
Connect a durable agentMIT licensed. Come and contribute.
The source is on GitHub under the MIT license. Bug reports from tmux and zellij setups are welcome, including reports of setups that work.
Installation
ColliePWA runs next to your agents, on the machine that already has them. The script downloads a release for your platform and verifies it. Building from source needs git and Bun, and is the route for a machine the releases do not cover. Both end with collie on your PATH, and neither one starts anything.
ColliePWA serves one operator running multiple coding agents on one host. It does not replace your terminal.
collie start runs tailscale serve on your MagicDNS hostname. Custom reverse proxies, meshes, and SSH tunnels are documented in the deployment guide. Single-user architecture only.$ curl -fsSL https://colliepwa.dev/install.sh | sh
A short POSIX sh installer. It skips sudo, starts no system services, and isolates files to ~/.local/share/collie and ~/.local/bin. It fetches the latest release, validates the published sha256 hash, writes the binary, and updates PATH. Requires curl, tar, and sha256 tools.
Served locally from this origin. Canonical source is located at scripts/install.sh in the repository. Inspect the script before running:
$ 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
Run collie update to fetch, verify, and switch to newer releases. Previous versions remain cached for collie update --rollback. Source builds update git revisions directly without release rollback targets.
Sourced from scripts/install.sh at 320bb18, 2026-10-03.
One step left: start it.
# 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
Configuration is optional and lives in ~/.config/collie/.env, the file start creates. Set COLLIE_TRUSTED_USER there, and the port or the front door if the defaults do not fit.
Access the generated URL from your mobile device over your local network. Add to home screen for full viewport mode.
FAQ
Yes. It is MIT licensed. There is no paid tier, no account and no cloud service behind it.
Yes. The interactive demo runs the real app in your browser, with made-up agents and panes. Nothing is installed and nothing is sent to a server.
No. ColliePWA is a web app served by your own machine. Open its address on your phone and add it to your home screen. On Android, Chrome offers an Install button for that. On an iPhone or iPad, use Safari's share sheet.
Yes. ColliePWA is a mobile client for Herdr. It is a web app that your own machine serves, so you open it in your phone's browser and add it to your home screen. There is nothing to install from an app store. You can also reach Herdr through an SSH app. Read how the Herdr mobile client works.
Termius and Moshi are terminal apps from the App Store or Google Play that connect over SSH. ColliePWA is a web app served by your machine and opened in your phone's browser. It lists the agents in your multiplexer, puts the ones waiting on you at the top, and includes a Keys tray with Esc, Tab, arrows and modifiers, so the phone keyboard is not your only input. Read the full comparison with Moshi.
Remote Control connects the Claude app or claude.ai/code to a Claude Code session on your machine, routing traffic through the Anthropic API. ColliePWA mirrors terminal panes. It works with whatever agent runs in them: Claude Code, Codex, OpenCode, pi and others, in every pane of your Herdr, tmux or zellij setup. It runs on your hardware. Your phone reaches it through a front door you run, Tailscale by default.
You can. That is how ColliePWA started. Driving a terminal UI through on-screen controls is clumsy: special keys are fiddly, Ctrl, Esc and arrows need awkward chords, and plain text input fights the soft keyboard. ColliePWA lets you tap the agent waiting on you, type normally, and hit Esc or Ctrl+C with one thumb.
Any agent that runs in a terminal pane. ColliePWA mirrors the pane itself and requires no agent API. The prompt cache timer on each pane supports Claude Code, Codex, OpenCode and pi. Questions and approvals from Hermes Agent become buttons. Messages from your phone reach the Cursor CLI input box, and ColliePWA checks every send to it while support remains provisional.
Herdr, tmux or zellij. Herdr is the primary backend. tmux and zellij work, but are experimental. tuios and Tern also work as experimental backends. collie start finds the ones you have and asks which one to mirror.
The host runs Linux or macOS. On Windows 11 x64, it runs against Herdr 0.9.3 or newer, and that support is experimental. A Windows machine cannot join a crew yet. On the phone, any current browser works.
No. Tailscale is the default, because collie start sets it up for you. A reverse proxy, Cloudflare Tunnel, NetBird or another mesh works too. The deployment guide shows each one.
Web Push needs two things: an HTTPS address and a key pair from collie push-keys. Over plain HTTP, the browser does not allow push, and the switch stays off. On an iPhone, add ColliePWA to the home screen first. Safari allows push only for a web app on the home screen.
ColliePWA gives remote shell access to your machine. That is what it is for. Every request needs the token of a device you paired, but anyone who pairs a device can read your panes and type into them. It listens only on loopback, so keep exactly one private front door in front of it, and pair your phone with collie pair. Never make it public with tailscale funnel. Read the security note before you run it.
No telemetry, no analytics and no crash reports. The only call it makes on its own is an anonymous update check against GitHub's public tags. Push goes through your browser's push service, and only after you turn it on. Voice input uses a cloud service only if you pick one over a local engine.
No. ColliePWA is for one operator. It has no user accounts and no per-person permissions. If you run agents on several machines, a crew puts all of them behind one address, for you alone.
Tap update in Settings on your phone, or run collie update on the host. Older versions stay on disk, so collie update --rollback takes you back.