Documentation

Guides

Install in five minutesThe recommended setup, step by step: Tailscale, Herdr and Collie on your computer, then a paired phone with Collie on its home screen
Claude Code in tmux or Herdr, on your phoneKeep Claude Code running in tmux or Herdr when SSH drops. Manage sessions, start new agents and worktrees, approve prompts, and send Esc or Ctrl from your phone with push alerts.

Sessions

SessionsWhat a session is, where sessions come from, a terminal or a durable agent, and what the phone shows for each
TerminalsPointing Collie at Herdr, tmux, zellij, tuios or Tern, what each can answer, and agent beacons. Experimental for tmux, zellij, tuios and Tern; bug reports wanted

Durable agents

Durable agents (experimental)Show your own durable agent on your phone: the quickstart, collie durable attach and sources.json, the three verbs, tokens, the files Collie keeps, and the versions
Durable agents on the phoneWhat a durable agent's section, conversations, questions and receipts look like
Troubleshooting a durable agentA durable agent that does not show up or says Unreachable: the first checks, every reason and what fixes it, the doctor rows, and the cases that come up
Security of a durable agentWhat a durable agent can and cannot do, the trust rules of the socket and of the token, what Collie does to a durable agent's text, and what the audit log keeps
The durable SDK (experimental)The npm package @colliepwa/durable-sdk, part by part: its entries and runtimes, openCollie, the pane methods, the four kinds of question and requireApproval, hooks, history, caps, the helpers, the Pi glue and the versions
The durable wire (experimental)What travels between Collie and a durable agent, for a builder: the routes, hello and the epoch, the life of an ask and the request ids, the socket and token transports, the limits and the version rule, with a link to WIRE.md for the exact rules

Reference

InstallThe front door you need, then the install for your system: Linux, Arch and Omarchy, Nix, macOS, Windows, or as a Herdr plugin. Covers first run, setup on an iPhone or Android phone, updates, and uninstallation
WindowsWindows 11 with Herdr: what is supported, installing with install.ps1, the unsigned binary, updating, long paths, and what is not tested
SecurityWhat a Collie exposes, the defenses, and pairing a device, the credential for every request
ConfigureThe .env, your own slash commands, keys, quick replies, launchers and typefaces; appearance, Zen mode, language
ThemesThe four looks Collie ships, picking one in Settings, importing a theme file after a preview, exporting one to edit, and writing your own: the 43 colour tokens, the shape and look words, the terminal palette, and what a theme cannot change
ChangesThe Files screen: a workspace's folder with its changes marked, the changed files and their diffs, and the last commit, from the pane or the dashboard's Files tab. Read-only git, nested repos, and the two settings that decide how far it looks
DeploymentFront doors other than the default: an identity-aware proxy, a reverse proxy with no Tailscale, an off-host ingress, several Collies on one host (one per user, or several instances for one user), and a crew's standby door
CommandsEvery collie verb, putting collie on your PATH, and the Herdr actions that mirror the verbs on a Herdr-managed install
CrewsSeveral machines' Collies behind one URL: invite, join, deputy, failover
Walky talkyMessages between agent sessions: collie walky who, send, reply, inbox and status, pane tokens, receipts, how a message crosses a crew and how its outcome comes back, the phone's cards and composer, installing the skill into your agents, and the limits
Voice input and Web PushThe microphone in the composer, and notifications when an agent is waiting on you
Manage & updateUpdate from the phone or the terminal, roll back, update a crew, cross a major, stop, uninstall, and upgrading a 0.x install to 1.0
TroubleshootingSymptoms in the words you would actually search for
TerminologyCollie's words in plain words, beside the names other tools use: session, space, tab, pane, terminal, durable agent, harness, crew, lead, and more

Documentation

Installation, configuration, and troubleshooting guides.

Guides

Install in five minutesThe recommended setup, step by step: Tailscale, Herdr and Collie on your computer, then a paired phone with Collie on its home screen
Claude Code in tmux or Herdr, on your phoneKeep Claude Code running in tmux or Herdr when SSH drops. Manage sessions, start new agents and worktrees, approve prompts, and send Esc or Ctrl from your phone with push alerts.

Sessions

SessionsWhat a session is, where sessions come from, a terminal or a durable agent, and what the phone shows for each
TerminalsPointing Collie at Herdr, tmux, zellij, tuios or Tern, what each can answer, and agent beacons. Experimental for tmux, zellij, tuios and Tern; bug reports wanted

Durable agents

Durable agents (experimental)Show your own durable agent on your phone: the quickstart, collie durable attach and sources.json, the three verbs, tokens, the files Collie keeps, and the versions
Durable agents on the phoneWhat a durable agent's section, conversations, questions and receipts look like
Troubleshooting a durable agentA durable agent that does not show up or says Unreachable: the first checks, every reason and what fixes it, the doctor rows, and the cases that come up
Security of a durable agentWhat a durable agent can and cannot do, the trust rules of the socket and of the token, what Collie does to a durable agent's text, and what the audit log keeps
The durable SDK (experimental)The npm package @colliepwa/durable-sdk, part by part: its entries and runtimes, openCollie, the pane methods, the four kinds of question and requireApproval, hooks, history, caps, the helpers, the Pi glue and the versions
The durable wire (experimental)What travels between Collie and a durable agent, for a builder: the routes, hello and the epoch, the life of an ask and the request ids, the socket and token transports, the limits and the version rule, with a link to WIRE.md for the exact rules

Reference

InstallThe front door you need, then the install for your system: Linux, Arch and Omarchy, Nix, macOS, Windows, or as a Herdr plugin. Covers first run, setup on an iPhone or Android phone, updates, and uninstallation
WindowsWindows 11 with Herdr: what is supported, installing with install.ps1, the unsigned binary, updating, long paths, and what is not tested
SecurityWhat a Collie exposes, the defenses, and pairing a device, the credential for every request
ConfigureThe .env, your own slash commands, keys, quick replies, launchers and typefaces; appearance, Zen mode, language
ThemesThe four looks Collie ships, picking one in Settings, importing a theme file after a preview, exporting one to edit, and writing your own: the 43 colour tokens, the shape and look words, the terminal palette, and what a theme cannot change
ChangesThe Files screen: a workspace's folder with its changes marked, the changed files and their diffs, and the last commit, from the pane or the dashboard's Files tab. Read-only git, nested repos, and the two settings that decide how far it looks
DeploymentFront doors other than the default: an identity-aware proxy, a reverse proxy with no Tailscale, an off-host ingress, several Collies on one host (one per user, or several instances for one user), and a crew's standby door
CommandsEvery collie verb, putting collie on your PATH, and the Herdr actions that mirror the verbs on a Herdr-managed install
CrewsSeveral machines' Collies behind one URL: invite, join, deputy, failover
Walky talkyMessages between agent sessions: collie walky who, send, reply, inbox and status, pane tokens, receipts, how a message crosses a crew and how its outcome comes back, the phone's cards and composer, installing the skill into your agents, and the limits
Voice input and Web PushThe microphone in the composer, and notifications when an agent is waiting on you
Manage & updateUpdate from the phone or the terminal, roll back, update a crew, cross a major, stop, uninstall, and upgrading a 0.x install to 1.0
TroubleshootingSymptoms in the words you would actually search for
TerminologyCollie's words in plain words, beside the names other tools use: session, space, tab, pane, terminal, durable agent, harness, crew, lead, and more

ColliePWA

Your agent herd, from your phone.

Herdr mobile client Durable agents ColliePWA vs Moshi Source Releases Discussions

ColliePWA is MIT licensed. It runs locally on your host over your private network.

Author: @altanbln