Herdr Agent Watcher

herdr-agent-watcher

**English** · [简体中文](README.zh-CN.md) · [日本語](README.ja.md)

Coding-agent observability for [Herdr](https://herdr.dev): live sidebar cards, lifecycle notifications, and a zero-config metrics bridge for Claude Code.


*Five sessions across four agents in one pane — working, finished, idle. The expanded Claude card also carries CONTEXT, CACHE and COST: numbers Claude Code reports through a status line and nowhere else, which is what the bridge puts there.*

The idea began inside [Vimeflow](https://github.com/winoooops/vimeflow), where watching coding agents was one layer of a much larger Electron app.

Pairs with [herdr-agent-title-sync](https://github.com/winoooops/herdr-agent-title-sync), which keeps Herdr pane titles in step with what each agent is doing.

Local observation is the default. The one thing that leaves your machine is Kimi's plan-usage lookup, which is off until you turn it on — see [Kimi usage consent](#kimi-usage-consent).

Install

herdr plugin install winoooops/herdr-agent-watcher

Requires Herdr 0.8.0+. Install fetches a prebuilt binary for macOS and Linux (x86_64 and arm64) and checks its SHA256. If no asset matches your platform, or anything about the download fails, it builds from source instead — that path needs Rust 1.88+, which Herdr reports rather than installs.

Installing into an already-running Herdr server does not start the daemon. Run it once:

herdr plugin action invoke restart-daemon --plugin herdr-agent-watcher

Herdr's own stock UI works without the sidebar: it receives lifecycle notifications and pane metadata tokens — `agent_watcher_state`, `agent_watcher_phase`, `agent_watcher_model`, `agent_watcher_context_pct`, `agent_watcher_attention` and `agent_watcher_title`. Those names are the integration surface with Herdr and are deliberately stable.

Commands

Every action is invoked the same way:

herdr plugin action invoke  --p