herdrm

herdrm is a native macOS console for Herdr. Rechecked 2026-08-19: github.com/missuo/herdrm had 121 stars, latest release 0.2.3, first published the same day. The README describes it as a window on top of herdr: you see every coding agent across local and remote machines, then attach to its live PTY. It is not a replacement for Claude Code, Codex, or OpenCode. It is also not Waku. Waku drives agent CLIs itself; herdrm talks to a running herdr server.

Author is Vincent Yang (@m1ssuo). The repo has no LICENSE file as of 2026-08-19, so do not treat it as a named open-source license. The maintainer marks it early-stage software without full test coverage.

Key Features

• All devices in parallel: Local herdr plus remotes over SSH (ssh -L socket forward). Automatic reconnect, sidebar aggregation, tinted name chips, and a bottom-left device filter.
• Spaces and agents sidebar: Claude, Codex, Gemini, Grok, OpenCode, and other herdr-detected CLIs. Blocked agents rise to the top, working ones spin, done ones get a check.
• Live terminal: Selecting an agent runs herdr agent attach. Full TUI, precise cursor, no chat wrapper. The terminal embed is SwiftTerm.
• Notifications: A system notification when any agent on any device finishes or needs input. Click jumps to that agent. Agents you are watching do not notify.
• New Agent: Starts an agent in any space on any device. The picker only lists CLIs installed on that machine. Bypass-permissions flags are on by default (for example --dangerously-skip-permissions for Claude).
• Search: Command-K palette across agents and spaces on every device.
• Mac packaging: Light and dark, Sparkle auto-updates, signed and notarized. macOS 14+.

Use Cases

Who Should Use This Tool?

• Herdr users on a Mac who want a native window instead of only the herdr TUI.
• People running agents on several machines (laptop plus a remote box) who need one sidebar.
• Developers who want the real PTY, not a chat-style wrapper around the agent.

Problems It Solves

1. One TUI per machine: herdr already keeps agents alive; herdrm aggregates those runtimes into one Mac window.
2. Missed blocked agents: Live status plus notifications surface the agent waiting on you.
3. Remote attach friction: SSH tunnels are managed for you; the remote socket looks like the local one.

Limitation: herdrm is a client. If herdr is not running, there is nothing to attach to. It is Mac-only. The default bypass-permissions flag is a real security tradeoff, not a convenience footnote. Expect bugs.

Pricing

Advantages

1. Console, not another runtime: Unlike Waku or VelaTerm, herdrm sits on herdr's socket API instead of owning the terminals itself.
2. Real PTY: No chat wrapper. You get the same TUI the agent already draws.
3. Multi-device by default: 0.2.0 keeps every device connected, not just the selected one.

Getting Started

1. Install and start Herdr on the Mac and on any remote you care about.
2. Install the console: brew install owo-network/brew/herdrm, or unzip the latest herdrm-x.y.z.zip from Releases into /Applications.
3. Add remote devices if needed. herdrm uses your local SSH keys and auto-accepts unknown host keys (accept-new) as of 0.2.1.
4. Watch the sidebar. Click a blocked row or a notification to attach.

First-party source: github.com/missuo/herdrm.

Frequently Asked Questions

Does it replace Herdr?

No. herdrm is a SwiftUI console. Herdr is the background server that owns the terminals.

Which agents show up?

Whatever herdr detects on that device. The README lists claude, codex, gemini, grok, opencode, and more.

Is there a Windows or Linux app?

No. macOS 14+ only. The iOS client in the same ecosystem is Heeler, which herdrm credits for its domain model.

Is it the same as Waku?

No. Waku is a standalone Mac harness. herdrm borrowed Waku's sidebar look and talks to herdr.

Alternatives

• Herdr: The runtime. Use the TUI if you do not want a Mac app.
• Waku: Native Mac app that drives CLIs itself, no herdr required.
• VelaTerm: Terminal and agent manager with its own session tree.
• Happy: Mobile and web client for Claude Code, not a herdr console.

Tips

1. Install herdr first. The app is empty without a live socket.
2. Treat default bypass-permissions as a choice, not a must. Turn it off if the machine is not isolated.
3. Use the All Devices filter after 0.2.0 so blocked remotes are not hidden behind the selected machine.
4. If you only needed the herdr TUI, skip the extra app.

Conclusion

herdrm is a same-day-shipping Mac console for people already on herdr: one signed window, live PTYs, and every device in the sidebar. Start at the GitHub repo, install Herdr, then decide whether the TUI was already enough.