{
  "markdown": "# Herdr Connect\n\n[简体中文](docs/zh-CN/README.md)\n\n**Control your Herdr agents from your iPhone — with no cloud in between.**\n\n[![Herdr Connect — LAN Discovery Demo](https://img.youtube.com/vi/BxX4ijalnzI/maxresdefault.jpg)](https://youtu.be/BxX4ijalnzI)\n\nHerdr Connect is a companion app for [Herdr](https://github.com/ogulcancelik/herdr). See what every agent is doing, read their latest output, send a follow-up, and get a nudge when a job finishes — while your data stays on your own network.\n\n<p>\n  <img src=\"assets/screenshot-agents.png\" alt=\"Agent list\" width=\"200\" />\n  <img src=\"assets/screenshot-detail.png\" alt=\"Agent detail\" width=\"200\" />\n  <img src=\"assets/screenshot-settings.png\" alt=\"Settings\" width=\"200\" />\n</p>\n\n## Why Herdr Connect\n\n- **See everything at a glance** — every agent's status, workspace, and recent activity in one list\n- **Stay close to the work** — read output, send instructions, or interrupt a running turn\n- **Know when it's done** — sound, haptic, and notification cues when an agent finishes\n- **Private by design** — the phone talks directly to your daemon over the local network. No cloud relay, no accounts, no telemetry\n\n## Requirements\n\n- A computer running [Herdr](https://github.com/ogulcancelik/herdr) with at least one agent\n- An iPhone (Android is not yet available)\n- Both devices on the same network — your Wi-Fi at home, or a VPN such as Tailscale that puts them on the same virtual LAN\n\n## Quick start\n\n1. Make sure Herdr is installed and has at least one agent:\n\n   ```sh\n   herdr agent list\n   ```\n\n2. Install the daemon on the computer running Herdr (the download needs no Go, Node.js, or Xcode):\n\n   ```sh\n   curl -fsSL https://raw.githubusercontent.com/Tomyail/herdr-connect/main/install.sh | sh\n   ```\n\n   On Windows, download and extract the zip from the [Releases page](https://github.com/Tomyail/herdr-connect/releases) instead.\n\n3. Start it:\n\n   ```sh\n   ~/.local/bin/herdr-connect doctor\n   ~/.local/bin/herdr-connect service install\n   ```\n\n4. Install the iOS app via the **[Herdr Connect TestFlight beta](https://testflight.apple.com/join/ZkRzJ6rm)** and allow Local Network access when prompted.\n\n5. Pair your phone. This prints a one-time QR code — scan it from the app's Settings → Pair new device:\n\n   ```sh\n   herdr-connect pair\n   ```\n\n6. Open the Agents tab. Tap an agent to view its output, send messages, or interrupt it.\n\nSomething not connecting? Check that both devices are on the same network, pause VPNs that block local multicast, and look at firewall or guest-network isolation settings. The [daemon guide](docs/release/daemon.md) and [TestFlight troubleshooting](docs/release/ios-testflight.md) cover the details, and the [CLI guide](docs/cli.md) documents every command.\n\n## How it works\n\n```text\nHerdr CLI\n    │\nHerdr Connect daemon   ← runs on your computer\n    │\niPhone app             ← pairs, then talks to the daemon directly\n```\n\nThe daemon and the app find each other on the local network. Trust is established once, by scanning a QR code from the pairing command; after that the phone only accepts the daemon it paired with. For the full trust model and its current limits, see [LAN TLS and pairing](docs/security/lan-tls-pairing.md).\n\n## Project status\n\n| Area | Status |\n| --- | --- |\n| iOS app | Public TestFlight beta |\n| Discovery, pairing, secure transport | Implemented |\n| Agent list, output, focus, messaging, interrupt | Implemented |\n| Android | Not yet published |\n| Off-network remote access (relay + E2EE) | Future milestone |\n\n## FAQ\n\n**Can I use it away from home?**\nNot with an official relay — that is a future milestone. If you already run a mesh VPN like Tailscale, the app works fine across it as long as the phone can reach the daemon; you are responsible for the VPN's security.\n\n**Does my data go to a server?**\nNo. The app talks directly to the daemon on your network. There is no cloud relay and no account system.\n\n**Which Herdr versions are supported?**\nThe app and daemon negotiate versions and will prompt you to upgrade when they don't match. See the [daemon guide](docs/release/daemon.md).\n\n## Documentation\n\n| Audience | Start here |\n| --- | --- |\n| Install and pair | [Quick start](#quick-start), [daemon guide](docs/release/daemon.md), [TestFlight troubleshooting](docs/release/ios-testflight.md) |\n| CLI reference | [CLI guide](docs/cli.md) |\n| Security model | [LAN TLS and pairing](docs/security/lan-tls-pairing.md) |\n| Architecture and contributor docs | [OpenWiki](openwiki/quickstart.md) |\n\n## Develop from source\n\nSetup, repository layout, and the full workflow live in OpenWiki: [development setup](openwiki/development/setup.md), [testing guide](openwiki/development/testing.md).\n\n```sh\ncorepack enable\npnpm install --frozen-lockfile\npnpm demo:lan      # run a local daemon on TCP 9808\npnpm ios:mobile    # Expo development build on a physical iPhone\n```\n\nThe app needs native modules (mDNS, pinned TLS, camera, notifications), so use an Expo development build, not Expo Go.\n\n## Security\n\nDo not report vulnerabilities or sensitive data in public issues — follow [SECURITY.md](SECURITY.md).\n\n## Contributing\n\nBug reports, reproducible discovery or pairing failures, and design feedback are welcome in [GitHub Issues](https://github.com/Tomyail/herdr-connect/issues). Please read [CONTRIBUTING.md](CONTRIBUTING.md) first.\n\n## Relationship to Herdr\n\nHerdr Connect is an independent companion project, not affiliated with or endorsed by the Herdr project. Herdr is installed separately and remains subject to its own license.\n\n## License\n\nLicensed under the [Apache License 2.0](LICENSE).\n",
  "bytes": 5621,
  "sha": "70806d5d5cfbda469f69c7cb2a3b733471814b67e3475969d3cc7a1d5dbac144",
  "repo_slug": "tomyail/herdr-connect",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_tomyail_herdr_connect_openwiki_index_md_25c7b7a3/readme"
}