herdr plugin adds AI agent inbox with session management

Douglas Correa's herdr-agent-inbox plugin enhances the herdr coding agent interface with an inbox metaphor and session management tools. The plugin requires herdr ≥ 0.7.0 and python3 (3.11+ recommended) and is installed via `herdr plugin install douglascorrea/herdr-agent-inbox`.

Core features include automatic session titling—each agent pane receives a real title derived from its conversation (e.g., "Fix flaky payment webhook tests") by reading the agent's native transcript from Claude, Pi, or Codex, with optional LLM summarization. The Agents sidebar transforms into an attention queue ordered by state: blocked (red !) → finished-unseen (blue ●) → working (yellow ▸) → idle (green ○) → settled (flag ⚑) at the bottom. Users settle an agent when done; it auto-reopens the moment it works again. Individual agents can be marked unread to pin them back to the top. Running times display how long each session has lived and how long it has been in its current state. Workspace rollups show agent state counts and the longest-running busy stint. Closed conversations are stored in a global history browser and can be reopened in place with native resume commands (`claude --resume`, `pi --session`, `codex resume`).

The popup interface, opened with `prefix+i`, offers four views rotatable with `g`: tree, compact, grouped, and flat. History view (opened with `h`) shows every closed chat newest-first, with ↩ indicating resumable conversations. Keyboard actions include `enter` or `double-click` to focus an agent, `s` or `right-click` to settle, `u` to mark unread, `c` to clear flags, `S` to settle all finished agents, `r` to regenerate titles, and `q` or `esc` to close. The daemon, started automatically by the plugin's startup hook, subscribes to herdr socket events, diffs the agent list, derives titles, and reports metadata. State (settle/unread flags) lives in state.json keyed by terminal ID and survives restarts; closed chats append to history.jsonl. Configuration is hot-reloaded from a local config.toml file. Title summarization, if enabled, runs on an async worker with a 60-second timeout and is cached per prompt content, falling back to the truncated raw prompt until completion. Privacy is local by default: titles and chat history are stored locally and rendered in the sidebar; if summarize is enabled, prompt excerpts are piped only to the configured command, sending nothing off-machine unless that command does so. The plugin uses herdr's public API and stdlib Python only, with no fork or patches required.

The herdr-agent-inbox plugin addresses a practical pain point in multi-agent AI workflows: as developers run more coding agents in parallel, tracking which tasks are blocked, finished but unseen, still working, or complete becomes unwieldy. The plugin's core innovation is inbox-style triage—borrowed from T3 Code's "settle" workflow—where agents slide to the bottom once marked done and auto-reopen if they produce new work. This inverts the traditional flat sidebar into a dynamic attention queue.

The plugin achieves this entirely through herdr's public plugin API using only stdlib Python, avoiding the need for forks or patches. Session titles are derived from agent transcripts (Claude, Pi, Codex) and can optionally be summarized by any LLM command the user configures; importantly, this summarization happens locally and only sends data off-machine if the configured command does so. Closed chats accumulate in a history browser accessible via `h`, enabling asynchronous context switching without losing past work. The state daemon persists settle/unread flags and chat history across restarts, keyed by terminal ID.

No comments yet. Be the first to share your thoughts!