winoooops

Herdr Agent Watcher — Development skill for Claude Code

Development community

Coding-agent observability for Herdr: live sidebar cards, lifecycle notifications, and a zero-config Claude Code metrics bridge.

How to install Herdr Agent Watcher

This entry records only its repository, not the path inside it, so there is no exact command to give. Open winoooops/herdr-agent-watcher and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Herdr Agent Watcher does

Coding-agent observability for Herdr: live sidebar cards, lifecycle notifications, and a zero-config Claude Code metrics bridge.

Alternatives in Development

Sanitize — Detect and redact PII from text files — 15 categories (SSNs, credit cards, API keys, etc.), zero dependencies 3.1k ★
Herdrm — Native macOS console for herdr — all your coding agents and their live terminals, across devices 635 ★
Claude Notifications Go — Cross-platform smart notifications -- 6 types, click-to-focus, context analysis, webhooks 365 ★

README

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.

![The Agent Watcher sidebar](docs/sidebar.png)

*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.