agents-supervisor

Dispatch, prompt, and monitor coding agents through the Herdr CLI with session pinning and report collection.

Updated Jan 19, 2023
One-click install
npx skills add https://github.com/inkfin/dotfiles --skill agents-supervisor-inkfin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-supervisor
Source: https://github.com/inkfin/dotfiles/tree/main/dot_agents/skills/exact_agents-supervisor
Command: npx skills add https://github.com/inkfin/dotfiles --skill agents-supervisor-inkfin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multiple coding agents across sessions, tabs, and worktrees is error-prone: agents get spawned in the wrong session, prompts land on blocked panes, and long answers vanish inside alternate-screen TUIs. This Skill defines a policy for dispatching, prompting, monitoring, and sweeping agents through the Herdr CLI so delegated work stays organized and auditable. ## Core Features & Use Cases - Session pinning and targeting: Detect inside/outside host mode, pin a single Herdr session, and target agents by name or pane_id without hijacking the user's focused pane. - Agent lifecycle management: Start agents with model and permission flag presets, reuse live agents before spawning new ones, and send self-contained prompts with goal, location, constraints, and deliverable fields. - Monitoring and sweeps: Read agent state safely, surface blocked approval dialogs to the user, and run read-only sweeps grouped by session and status. - Use Case: You ask to delegate a bug fix on a new branch. The Skill pins the running session, creates a worktree and tab, starts a Cursor agent with the right model flags, waits for completion, and summarizes the Markdown report file. ## Quick Start Ask the assistant to spin up a coding agent on a specific task in the current repository and report back when it finishes.

Frequently Asked Questions about agents-supervisor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I dispatch a coding agent with Herdr?

Pin a session with herdr session list and HERDR_SESSION, then create a shell pane and run herdr agent start with a job-slug name. Send a self-contained prompt covering goal, location, constraints, and deliverable using herdr agent prompt with --wait.

How do I monitor multiple running coding agents?

Use herdr agent list, agent get, and agent read with the recent-unwrapped source to inspect state without marking tabs seen. A full sweep iterates every running session, groups agents by status, and reports blocked items first.

Does Herdr agent dispatch work on Windows?

The setup flow supports Linux and macOS only; on Windows you point at the Herdr service instead of installing locally. The herdr --remote TUI attach does work from Windows clients for viewing remote sessions.

Why does herdr agent prompt return agent_blocked?

agent_blocked means the target agent is waiting at an approval or question dialog, so the prompt was not sent. Inspect the pane with agent get or agent read and bring the question to the user rather than answering it yourself.

When should I reuse an agent instead of starting a new one?

Check agent list for a live agent already covering the task before calling agent start. Spawn fresh only when no live agent matches, the old one failed or left a mess, or the user explicitly requests a new agent.