ColliePWA is a Herdr mobile app for iOS and Android. It also drives the new Herdr app, tmux and zellij. It displays your agent panes on your phone. See who is waiting, read the chat or the screen, and reply from anywhere, by typing or by voice.
Herdr is the primary backend. The new Herdr app works through its core, herdr-core, without rename and focus for now. 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
On your phone
No app store app, on purpose. ColliePWA is a progressive web app (PWA): your own machine serves it, and your phone's browser installs it on the home screen.
On your phone, ColliePWA lives on the home screen. This is how you put it there:
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.
The demo is not wired up in this build. Set VITE_DEMO_ORIGIN to the deployed demo, or read DEMO.md.
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.
Pick or paste a photo and a preview opens. Attach sends the original. Edit opens Crop, Draw, Circle and Arrow, so you can point at the problem. The agent reads the marked photo from its path.
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. Tap lines in a diff to leave a comment on each. Then bring all of them into your agent's draft at once. The view is read-only: git runs without hooks, filters or network access, and nothing edits, stages or commits.
Voice
Tap the microphone in the reply box and speak. Whistle, a small speech model, turns your voice into text inside the phone's browser. With Whistle on the phone, the audio is never uploaded, and dictation works offline once the model is there.
You can also use your own command, such as whisper-cli, any OpenAI-compatible endpoint, or your ChatGPT subscription through Codex. Nothing is on until you set it up.
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 (the TUI or the new app) 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.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 Herdr core, 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 links it into ~/.local/bin. If that folder is not on your PATH, it prints the line to add. 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 5cb4204, 2026-10-27.
Two steps left: start it, then pair your phone.
# name the multiplexer to mirror: herdr, herdr-core, tmux or zellij.# start writes it to ~/.config/collie/.env, so a bare collie start# is enough next time.$ COLLIE_MUX=herdr collie start# then pair your phone: it prints a code for Collie's Settings$ collie pair
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.
Open the URL on your phone over your tailnet, with the Tailscale app signed in. Add ColliePWA to the home screen, then pair it with the code that collie pair prints. See how to add it to the home screen
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 on iOS and Android for both the Herdr TUI and the new Herdr app. Your own machine serves the web app. Open it in your mobile browser and add it to your home screen. There is nothing to install from an app store. You can also connect to Herdr through an SSH app. An experimental ColliePWA panel for the Herdr app can pair a phone from inside the app. You copy that panel into place by hand. Read how the Herdr mobile app 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, Herdr app, 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, the new Herdr app, tmux or zellij. Herdr is the primary backend. On the Herdr app, ColliePWA drives its core, herdr-core. A machine with both keeps the Herdr TUI unless you name herdr-core. In a crew, one machine can run two ColliePWA instances, one per multiplexer, and the phone shows them as one machine. 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.
Yes, on iOS 16.4 or newer, once ColliePWA is on the home screen and you open it from its icon. The home screen app is separate from Safari, so pair it and turn on alerts there. The Web Push notes cover the rest.
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. The Whistle speech model downloads once from Hugging Face, and only when you tap to set it up.
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.