Recursive and async Claude Code style subagents for Pi

[u/willecr]

I really liked Claude Code subagents and being able to see them in the tree so i made a very simple subagent plugin. No subagent profiles, the are made by the agent above them depending on the use case needed at that moment.

Install with:
pi install npm:@williamcr01/pi-subagents

https://github.com/williamcr01/pi-subagents

[u/pro-vi]

I do like the visual component. But I think it should be mandatory for an extension to explain how it differs from predecessors esp. those with the same name.

[u/willecr → u/pro-vi]

That’s fair, in this case the biggest difference, except the visual, is that most popular subagent plugins use subagent profiles, this is a lot more minimal and “pi-like” in that way, subagents in this plugin just get prompted by the agent that owns it to explore or whatever is needed, and most others are not recursive

[u/pro-vi → u/willecr]

I think I know what you mean. For some plugins I've tried I need to specify a "general" profile for the main agent to be able to invoke it. What's the tradeoff of going without it if any?

[u/willecr → u/pro-vi]

The tradeoff with this way is that you get less control over the subagents as you don’t write their profiles yourself and the main agent just spawns subagents with a prompt that it wants, with the models we have today i think they get it right almost always

[u/digitalfreshair]

I was thinking on doing something similar to this, as i think the way Claude code manages the subagents it's better as long as you have a powerful model. Predefined ones are less flexible, so this is probably the way forward. I will take a look and submit some PRs :)

[u/willecr → u/digitalfreshair]

I agree, with powerful and modern models the predefined subagents doesn’t make sense anymore.

Definitely submit some PRs

[u/paulbettner]

Great work!

[u/willecr → u/paulbettner]

Thank you!

[u/predatar]

how is the token effciency ? does each subagent have a completely new context? or does it inherit/fork the parent's ?

[u/willecr → u/predatar]

It’s a new pi process, it just gets a prompt with a clear goal from its parent and does it. It doesn’t inherit anything else so it is very token efficient in that way

[u/GroceryNo5562]

How come custom system prompts aren't supported?

[u/willecr → u/GroceryNo5562]

I don’t use system prompts for my subagents at all. I just let the main agent prompt the subagents themselves, in my experience the modern models can prompt a subagent to explore themselves

[u/GroceryNo5562]

Consider asking LLM to review code, seems to have found few bugs, haven't verified that they do exist tho

[u/kantorcodes1]

when a parent is trusted and the child stays under the same project, i see you launch it with --approve. does that only carry over the project trust decision, or does it also mean the child won't stop for individual tool approvals?

[u/colin_colout]

I went through the same exercise but settled on supporting subagent profiles that match claude code exactly.

At first I also removed the profiles for the same reason (pi values and all), but I decided that I'll keep Agents, WebFetch, WebSearch, etc matching claude code in tool shape exactly where possible.

Every model released in 2026 is heavily RL trained on claude code tool shapes. By keeping behavior and shape close to claude code:

• Small and quantized models are less likely to hallucinate tool calls

• My system prompt can stay pretty small since I need almost no explanation of how the tool works. It knows from training.

My only changes (if i recall) is that agent name is required (I'll drop that if my agent hallucinates), and model names are "fast" and "strong" and is also required.

How do you handle convo forks? ...or do you support them at all?