What do you want to do?
4 use cases
-
Delegate a background code investigation to an Agent
Hand a bounded read-only question to a background Agent while the Lead session stays free.
- Pi Herdsman
- Software and DevOps
- Intermediate
View prompt
Using the pi-herdsman repo, install the stack and ask a scout Agent to inspect <feature area> in <project path>. Expected output: a written summary of the flow from the scout Agent while the Lead session accepts other prompts. Verify that /agents lists the scout Agent while it runs.
-
Split a project into parallel branch work under a Manager
Use a Manager to coordinate several Leads, each working on its own durable Git branch.
- Pi Herdsman
- Software and DevOps
- Advanced
View prompt
Using the pi-herdsman repo, set up a Manager that assigns <number> independent tasks from <task list file> to Leads on separate Git branches. Expected output: a list of active Leads with their branch names and assignment status. Verify that each Lead is listed under the Manager's current project assignments.
-
Check token usage and cost for a session and its Agents
Read Pi-native token usage and cost for the current session and its owned Agent sessions.
- Pi Herdsman
- Software and DevOps
- Intermediate
View prompt
Using the pi-herdsman repo, run a task that delegates work to <number> Agents in <project path>, then open the /agents Session stats view. Expected output: token usage and cost totals for the Lead session and its owned Agent sessions. Verify that the totals include each delegated Agent.
-
Define custom Agents with your own models and tools
Write Agent definitions that use your own models, tools, skills, and workflow.
- Pi Herdsman
- Software and DevOps
- Advanced
View prompt
Using the pi-herdsman repo and its Agent definitions guide, create a custom Agent named <agent name> that uses <model or tool list> and delegate <task> to it in <project path>. Expected output: a completed result from the custom Agent. Verify that /agents shows the custom Agent running under the Lead session.
How to use Pi Herdsman
- Check you have what it needs: Linux or macOS for the released install script; Pi and herdr installed, or the install script to set them up; A Git project to work in.
- Open boadij/pi-herdsman on GitHub and read the README and license.
- Run
curl -fsSL https://raw.githubusercontent.com/boadij/pi-herdsman/main/install.sh | sh - Run
herdrin your project folder - Run
piinside the herdr pane - Type: Use scout to inspect the authentication flow.
These steps come from our top use case, Delegate a background code investigation to an Agent, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freePi Herdsman alternatives · Best AI repos for Software and DevOps
About this repo
- Who it is forDevelopers who already run coding agents in Pi and want several bounded Agents or parallel Leads working on one Git project.
- Why it is hot
- LanguageTypeScript
- Sourcegithub.com/boadij/pi-herdsman · Back to Hot repos
Requirements
- Linux or macOS for the released install script
- Pi and herdr installed, or the install script to set them up
- A Git project to work in
Maintain Pi Herdsman? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/boadij-pi-herdsman/?ref=badge)
Questions about Pi Herdsman
What is Pi Herdsman?
Pi Herdsman is an orchestration layer that connects Pi coding-agent sessions with herdr so that background, nested, and multi-branch Agents can work in parallel under explicit supervision. It is an open-source project on GitHub: https://github.com/boadij/pi-herdsman.
Who is Pi Herdsman for?
Developers who already run coding agents in Pi and want several bounded Agents or parallel Leads working on one Git project.
What can I do with Pi Herdsman?
4 use cases so far, for example: Delegate a background code investigation to an Agent; Split a project into parallel branch work under a Manager; Check token usage and cost for a session and its Agents. Each has steps and a copy-paste agent prompt.
What do I need to run Pi Herdsman?
Linux or macOS for the released install script; Pi and herdr installed, or the install script to set them up; A Git project to work in.
What are alternatives to Pi Herdsman?
Other hot AI repos in Software and DevOps: Harness2, iFixAi, Orca, Diagram Design, AI Memory.
Is Pi Herdsman safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.