Self-hosted · open source · MIT
wherdr is a web app and phone PWA for the agents running in Herdr on your machines — Claude Code, Codex, omp and more. Read their work, answer their questions, take over their terminal. From your laptop or your pocket, over your own private network.
curl -fsSL https://wherdr.dev/install | shLinux + Docker · macOS via Node.js · needs Herdr ≥ 0.9.1
01 Features
Same Herdr session, same agents, nothing copied. On a computer wherdr can replace the terminal client day to day; on a phone it follows your agents while you are away.
1.1 Conversation · terminal
wherdr reads each agent's own transcript — Claude Code, Codex, omp — and renders it as clean Markdown with grouped tool calls, images and search. Switch to the live terminal (xterm.js) to take over. Reading never resizes a pane.
1.2 Phone · notifications
Install wherdr on your phone as a PWA. A push tells you when an agent finishes or needs you, with its question and options. Answer right from the agent list, without opening the conversation.
1.3 herdr-projects
With the herdr-projects plugin, a coordinator conversation runs parallel threads, each in its own Git worktree. wherdr groups them under their project and shows the project's TASKS.md as a live board: to test, to decide, in progress, blocked, backlog — with one-click replies.
Herdr's real layout on a computer: every pane live, drag to move, drag a divider to resize.
Agents of the SSH machines registered in Herdr appear in their own section. Same features, remote.
5-hour window and week, with reset times, for every online machine.
Pick an agent, a folder, optionally a Git worktree and branch, and queue the first message.
Git status and diff of an agent's working folder, worktree management.
Global search, next agent, new tab, pane swaps, 1–9 to answer. Everything without the mouse.
Face ID, Touch ID, Windows Hello, Android. Sessions slide, devices can be locked remotely.
wherdr Titanium, herdr.dev, Herdr's own themes or follow Herdr. English and French.
Actions declared by your installed Herdr plugins show up in the menus.
02 How it works
wherdr runs on the same machine as the Herdr server. It uses Herdr's local socket API and CLI, reads the agents' transcript files, and serves the app to your devices through your private network. Your other computers join through Herdr's SSH machines.
→ Gateway
Nitro server: API, WebSockets, Web Push and lock, on 127.0.0.1:7683.
→ Read-only
Transcripts of ~/.claude, ~/.codex, ~/.omp are read, never written.
→ Passive client
Notifications come from Herdr's client socket without resizing anything.
03 Security
Anyone who reaches wherdr can drive your agents as your user. So it stays on your private network, behind a passkey, with nothing in the cloud.
wherdr listens on 127.0.0.1. Reach it from your devices through Tailscale Serve — never a public route, port forward or tunnel.
Once a passkey exists, the API, images and WebSockets need an unlocked session. Lock every device in one tap.
No account, no telemetry, no hosted service. wherdr talks to the Herdr socket on your server and reads transcripts read-only.
Host allow-list, Origin checks on every write and WebSocket, strict Content Security Policy, no framing.
Never port forwarding · public reverse proxy · Cloudflare Tunnel · ngrok · tailscale funnel
04 Install
With Herdr running, on the always-on Linux machine that hosts your agents (a Raspberry Pi works). The script checks Docker and Herdr, creates ~/wherdr, and starts the container on 127.0.0.1. No sudo, and it asks before replacing anything. Read it first.
curl -fsSL https://wherdr.dev/install | sh~/wherdr/docker-compose.yml and .env, then docker compose up -d.http://localhost:7683 on that machine.tailscale serve --bg --https=7683 http://127.0.0.1:7683, put the address in APP_URL, install the app from the browser and enable notifications.Full guide, configuration and troubleshooting in the README.
05 FAQ
Free and open source. Watch the repository to hear about new releases.