ColliePWA

ColliePWA is an open-source (MIT) mobile client for Herdr, with experimental support for tmux and zellij. It is a self-hosted web app (PWA) for driving terminal AI agents such as Claude Code, Codex and OpenCode from your phone. Each instance connects to one multiplexer. It is served over Tailscale by default. Open the URL on an iPhone or Android phone to see which agent needs input and respond directly from your mobile keyboard.

Using Herdr? Read about the Herdr mobile client.

The input box uses a standard text field compatible with system voice dictation. Collie also includes built-in voice input that remains disabled until explicitly configured.

Features

• React Router + Vite with TypeScript, Tailwind, shadcn, and a Bun bridge
• Status dashboard led by what needs your input; every other pane sits under its own workspace, tab on the row
• Push notifications when an agent blocks on user input
• Quick actions and slash commands configured per agent
• Keypad for terminal control keys: Esc, Ctrl+C, arrows, and modifier combinations
• Output search and full conversation history beyond standard terminal scrollback
• Files screen: the files of an agent's workspace folder with the changes marked, and a Changes segment with what it changed in its git repos, as diffs with syntax colour, and its last commit, read-only
• File attachments: images from the camera roll, and markdown, text and code files
• Device pairing always on: a device needs its token for every request, reads and writes, and an unpaired browser sees only the pair screen
• Crews: several machines' Collies behind one URL, with operator-triggered failover
• Twelve UI languages and a per-device typeface setting
• Herdr session switching managed from the web interface
• PWA support running locally on loopback with no external accounts or cloud dependencies

Demo

Using Collie from a phone: the dashboard places agents that need input at the top. You can inspect spaces, tabs, and panes. Long-press a pane pill or tab chip to rename or close it; Claude panes reflect names set via /rename. Hold a dashboard row or a pane pill, or right-click it with a mouse, to pin that pane to the top of the dashboard and the switcher. Tap to answer an AskUserQuestion prompt, switch between herds, and receive push notifications when an agent blocks on input.

The interactive demo runs the web client in your browser against mock data without installation.

Motivation

I wanted to check on my agents from my phone. The usual route is Termux to SSH in and attach to the terminal multiplexer session. Driving a TUI through on-screen controls is clumsy: special keys are fiddly, Ctrl/Esc/arrows require awkward chords, and simple text input fights the soft keyboard. I wanted a mobile interface instead of a terminal shoehorned onto a touchscreen. Collie lets you tap the agent that needs input, type normally, and send Esc or Ctrl+C with one thumb.

Who is this for

Collie is for developers running AI agents in a terminal multiplexer who want to resume sessions from a phone. Herdr is the primary supported target in 1.0. Support for tmux and zellij is experimental: both run, but testing is limited to a single operator on one machine. If you use either, bug reports are welcome, including reports of working setups.

The setup assumes a Tailscale tailnet. Your phone and host must share a tailnet, with tailscale serve configured as the default ingress. Collie is single-user: it supports one operator on one tailnet, with no multi-tenant authentication. Do not use it for shared or public access. Read the security section below before running it.

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.

Quickstart

New to Tailscale or Herdr? Install in five minutes walks the whole setup, from an empty computer to Collie on your phone.

Run this on the host, not your phone. It requires curl, tar, and a sha256 utility. It needs no compiler toolchain and does not ask for sudo:

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

The script downloads the latest release for your platform, verifies the sha256 checksum, installs the files, and puts collie on your PATH. It then prints the remaining manual steps: seed a config, then run collie start. You do not need to specify a multiplexer ahead of time. On its first run, collie start detects Herdr, tmux, and zellij, then prompts for your choice. If you prefer to build from source, docs/install.md covers manual builds, each system and package, Herdr routes, and adding Collie to the home screen of an iPhone or Android phone.

ColliePWA is not in the App Store or Google Play. You add it to your home screen from the browser, and that is the only way to install it on a phone.

Documentation

Guides

Reference