zog-tech/herdling

Watch and steer the AI coding agents on your own computers from your phone.
Website ·
Guide ·
Download ·
Contribute
The screenshots show the built-in demo computer.
Herdling is a phone app for herdr, the terminal workspace for AI coding agents.
It shows every agent on every computer you own: Claude Code, Codex, Pi, OpenCode and the other
agents that herdr runs. It tells you when an agent finishes or needs you, and you answer from the phone.
The phone connects straight to your computers over SSH. On each computer, a small companion
program, herdlingd, answers the app and sends the notifications. There is no account, and
Zog Tech runs no server for Herdling.
Herdling is not made by or affiliated with the makers of herdr, Claude Code, Codex, Pi, OpenCode, omp or Gemini CLI.
## Features
One board for every agent. The agents of all your computers in one list, grouped by status:
Needs you, Ready, Working and Idle. The agents that need an answer come first. A long press
shows the last reply.
A chat view. Read a session as a clean chat, with formatted replies, tool calls, subagents
and permission buttons. It works with Claude Code, Codex, Pi, OpenCode, omp and Gemini CLI,
with session resume and the command lists (/, $ and @) of the first four.
The real terminal. Switch to the live terminal of any agent, with Esc, Tab, Ctrl-C, the
arrow keys and Enter. It works with every agent that herdr runs. The computer pushes each new
screen, a sent line shows at once, and a badge shows the latency. "Type directly" sends each key
at once, for a hardware keyboard.
A notification when it matters. herdlingd sends a push when an agent finishes or waits
for you. A tap opens that session.
Quiet at the computer. No pushes while you use herdr at your desk, and for 5 minutes after.
Voice in and out. Speak a prompt: speech becomes text on the phone (also with a private
on-device model) or on your own computer. Herdling can read replies out loud, in full or as a
short summary.
Start new work. Start an agent in any folder on any computer, restart or resume a session,
rename sessions, tabs and workspaces, and review your automations.
Meters. The plan usage of Claude and Codex, and the CPU and memory of each computer.
Pairing with a QR code. herdlingd pair shows a one-time code. The phone gets its own SSH
key that can only run herdlingd rpc, and the app pins the host key of the computer.
No accounts, no servers. Session traffic goes only between the phone and your computers.
A push holds only the agent name, the agent kind and the terminal title.
A demo mode. The app has a demo host with made-up agents, so you can try it with no computer.
## Get it
iPhone (iOS 17 or later): on the App Store soon.
Android (Android 8.0 or later): on Google Play soon.
herdlingd for macOS and Linux, in one of three ways (see the
download page):
In the app (recommended). Settings > Hosts > Add host > Set up with password. When
herdlingd is missing, the app offers Install and pair. It runs the installer over SSH,
then pairs. No terminal, no sudo, and the app does not keep the password.
The one-line installer: curl -fsSL https://herdling.zog-tech.com/install.sh | sh. It downloads the GitHub