Tyru5

Herdr Agent State — Code Quality skill for Claude Code

Code Quality community

Realtime agent status pane for herdr; what each agent in the workspace is working on (in a more human-readable format).

How to install Herdr Agent State

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

What Herdr Agent State does

Realtime agent status pane for herdr; what each agent in the workspace is working on (in a more human-readable format).

Alternatives in Code Quality

  • Import Drawio — Redraw a draw.io file as an editorial diagram at a chosen format, size, and detail level 27.2k ★
  • Job Stories — Create job stories with acceptance criteria in JTBD format 7.8k ★
  • Video Script: Claude SEO V1.7.2 — What's New — Duration: ~5 minutes Tone: Natural, conversational, like talking to a friend who knows Claude Code Format: Scr 5k ★

README

herdr-agent-state

Realtime agent status pane for [herdr](https://herdr.dev/): one keybinding toggles a right split in the current workspace showing, in human-readable form, what each agent is working on — live.

⏱ agent state · herdr-state              q quit · prefix+shift+s toggle
╭─ claude-fable-5 (high) · herdr-state ─── ● working 3m12s ─╮
│ Create agent status display plugin for Herdr              │
│ ▸ Read  Read the socket client for context                │
│ ▾ Edit ×3                                                 │
│   ├─ Fixed the reconnect backoff in socket.rs             │
│   ├─ Added the status reconcile poll                      │
│   └─ Wired summaries into the card model                  │
│ ▸ Bash  Rebuilt the release binary                        │
│ Last response:                                            │
│   Now wiring the socket subscription so events stream…    │
│ time: 15:04:23                                            │
│ date: 2026-08-05                                          │
│ tok 64.5k cache · 2.5k out                                │
╰───────────────────────────────────────────────────────────╯

When an agent is `working` but nothing new has arrived for `thinking_after_ms` (default 5s), the card shows a static `thinking… 12s` note — the model is reasoning between tool calls, not hung.

Consecutive same-tool steps fold into one group row (`▸ Edit ×3 `), collapsed by default. `j`/`k` moves the fold cursor between groups (the selected header is highlighted); `enter`/`space` expands a group into the connector tree above and collapses it again.

How it works

Two data layers feed the pane:

  1. herdr socket ($HERDR_SOCKET_PATH) — the app holds a long-lived NDJSON connection: a session.snapshot seed, then events.subscribe on pane/agent lifecycle events. That supplies each pane's agent, status (idle / working / blocked / done), terminal title (the agent's own "what I'm doing now" str