{"id":"8628a55a-83e7-407b-8602-e348d167fc8e","slug":"wherdr","kind":"skill","name":"wherdr","summary":"Use Herdr from anywhere — your iPhone, Android phone or any browser. Watch your coding agents, answer them and run your herdr-projects, privately and securely.","owner":"afloury","repoUrl":"https://github.com/afloury/wherdr","license":"MIT","licenseTier":"permissive","trust":"community","stars":9,"match":null,"fewStars":false,"format":"skill","createdAt":"2026-09-27T14:07:17.000Z","addedAt":"2026-10-21T23:53:04.927Z","logoUrl":"https://avatars.githubusercontent.com/u/18677074?u=269b9426db9699eaf53edd618b41d5958988589a&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["browser-web","developer-tools"],"tags":["herdr","herdr-plugin","ai-agents","claude-code","codex","mobile","pwa","tailscale"],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-25T18:51:17.448Z","sample":false,"url":"https://conduits.dev/tools/wherdr","language":"TypeScript","transports":["stdio"],"install":{"npm":"wherdr"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# wherdr\n\n**Upgrading to 2.0.0?** Read the [release notes](docs/release-notes-2.0.0.md) for breaking changes and the 1.x migration checklist.\n\nwherdr is an unofficial, self-hosted web client for [Herdr](https://herdr.dev).\nStart coding agents on your computer, follow their work and reply from your phone or browser.\nIt uses the same Herdr session, with live conversations, real terminals and a herdr-projects Board.\n\n![Compact agent list and a task conversation on desktop](docs/screenshots/desktop.png)\n\n[Try the demo](https://wherdr.dev/demo/) · [Website](https://wherdr.dev) · [Launch film](assets/wherdr-launch.mp4)\n\n## Quick start\n\nOn the Linux or macOS computer running **Herdr ≥ 0.9.1**, run:\n\n```sh\ncurl -fsSL https://wherdr.dev/install | sh\n```\n\nThe installer checks prerequisites, offers Node.js 22 if needed, installs the Herdr plugin\nand starts wherdr as your user at **http://localhost:7683**. It also configures automatic\nstartup: at login on macOS; at boot on Linux with lingering enabled, otherwise at login. The installer reports which case applies.\nOpen that address, or press **prefix+i** in Herdr, to follow the setup guide: agents, phone access\nthrough Tailscale, optional passkey lock and notifications. See [first launch](docs/quick-start.md).\n\nPrefer help from your coding agent? Paste:\n\n```text\nRead https://wherdr.dev/agent.md and help me set up wherdr. Check what is already installed first, and ask me before installing anything.\n```\n\n**wherdr is a remote shell as your user.** Keep it on localhost or a private network such as\nTailscale; never expose it to the public Internet. Read [Security](docs/security.md) before remote access.\n\n## Documentation\n\n- **[Overview and architecture](docs/overview.md)** — What wherdr does, why it exists and how it connects to Herdr. Includes the launch film and license.\n- **[First launch](docs/quick-start.md)** — Install the native service and follow the setup guide. Includes the desktop, Board and phone screenshots.\n- **[Home and agent list](docs/home.md)** — Find agents, create a session and filter machines or projects. Covers compact rows and state grouping.\n- **[Conversation and replies](docs/conversation.md)** — Read transcripts, answer questions, attach files and manage drafts. Includes quoted replies and decision tables.\n- **[Terminal](docs/terminal.md)** — Use the real terminal, copy text, open links and paste images. Explains take-over and size restoration.\n- **[Files and changes](docs/files.md)** — Review Git changes and comment on lines or blocks. Compose a review for the agent.\n- **[Computer, phone and iPad](docs/devices.md)** — Use split panes, keyboard shortcuts and touch controls. Describes device-specific layouts.\n- **[Installation and updates](docs/installation.md)** — Requirements, native installer, agent PATH, updates and migration from Docker.\n- **[Migrate from a 1.x Docker install](docs/migrate-from-1.x-docker.md)** — Move a wherdr 1.x container to the native 2.0 service, keeping its port, passkeys and data. Written so an AI agent can run it step by step.\n- **[Phone access and private networks](docs/networks.md)** — Set up Tailscale or another private network with HTTPS. Includes always-on servers and keep-awake.\n- **[The wherdr command](docs/command.md)** — Install through npm or Homebrew and manage the native service from the command line.\n- **[Herdr plugins](docs/plugins.md)** — Install and configure the wherdr plugin, its panel key and plugin actions.\n- **[Install as an app](docs/phone.md)** — Add wherdr to your home screen on a phone or install it in a desktop browser.\n- **[Settings and configuration](docs/configuration.md)** — Configure the service through environment variables and the app through shared and device-specific preferences.\n- **[Machines and SSH](docs/machines.md)** — Register remote machines and use their agents through SSH. Includes sessions and connection troubleshooting.\n- **[Claude and Codex quotas](docs/quotas.md)** — Show remaining usage and handle Codex updates, limits and restarts.\n- **[Notifications](docs/notifications.md)** — Enable Web Push, relay Herdr notifications and configure Do not disturb.\n- **[Board and coordinators](docs/board.md)** — Work with herdr-projects tasks, reviews, approvals and coordinators across machines.\n- **[Security](docs/security.md)** — Understand remote-shell access, passkeys and network restrictions. Read this before enabling remote access.\n- **[Development and tests](docs/development.md)** — Run from source and follow the contribution and agent test rules.\n- **[Troubleshooting](docs/troubleshooting.md)** — Resolve startup, permissions, network, SSH and conversation problems.\n\n[All documentation](docs/README.md) · [Contributing](CONTRIBUTING.md) · [Changelog](CHANGELOG.md) · [MIT license](LICENSE)\n\nUnofficial project; not affiliated with or endorsed by Herdr, Anthropic or OpenAI.\n"}