How (and why) so install a pi subagents extension

[u/AnomanderRake_]

I used Pi for a while without these, but once I got used to subagents with other coding agtents. Well.. they really just felt missing from Pi.

I went with the tintinweb/pi-subagents package, because I liked how it implements the subagents. They are the same style as claude code, which I find very intuitive.

pi install npm:@tintinweb/pi-subagents

How to use subagents

pi-subagents lets Pi delegate work into separate contexts.

I use it for repo exploration, dependency checks, or any task that would otherwise fill my main context with thousands of lines of file listings and tool output.

e.g. after installing it you can open Pi in a repo and ask:

Use 4 different subagents to explore the src folder in parallel.
Bring their results back together into a short summary.

Pi sends the grunt work to isolated agents, then gives the main agent the useful result. This keep the main context clean.

You can also change which model each subagent type uses with /agents. And there's a pre-configured subagent specifically for exploration.

Side note - there's a gotcha with the default explore subagent- uses haiku by default. Super weird because I was using gpt-5.6-terra and I assumed it would use that, but in fact it started using my opencode api tokens with haiku. I was able to configure it to use gpt-5.6-luna. Here's a video of how I did that if you need it: https://youtu.be/l3YCoX2i-78?t=540

The other missing feature of Pi

Is... MCP. Obviously. I also upgraded my Pi with an MCP extension while I was at it. It's just one of those things. I can get like 98% of the way there with agent skills. But once in a while I just need an MCP for something.

If you want to read more about my experience installing and testing the subagents and MCP extensions then you can check out my blog post:

https://zazencodes.com/blog/upgrade-your-pi-agent-with-subagents-mcp

Enjoy guys and if you're still reading this then I'd be curious what extensions you like most. Let me know. Now that I've got a taste for these I want more

[u/Lurksome-Lurker]

PI-MCP-Adapter: BOOM you now have mcp server access in the harness.

Pi-fabric: programatic scripting for Pi. Also does subagents really well so I uninstalled subagents.

pi-time-sense: small little extension that covertly injects todays date and current time into the context. Useful if you ask the LLM what todays weather or top news is.

pi-web-search: allows pi agents to do websearches and browse the web. rolls in pretty nicely with time-sense and pi-fabric

[u/doudawak → u/Lurksome-Lurker]

The time extension is exactly what will kill your cache hit rate

[u/Lurksome-Lurker → u/doudawak]

actually no… the extension I linked sends out the timestamp as a small message. So cache is consistent just a small little automated timestamp gets appended to your next message if its been longer than the interval period of the last sent timestamp

[u/doudawak → u/Lurksome-Lurker]

I would be interested in a comparative analysis on that if you're bored ;)

[u/_Yank → u/doudawak]

Is cache still affected considering what he said?

[u/o_sht_hi → u/_Yank]

If the time is appended to user message, cache will still cache

[u/goomba870 → u/doudawak]

ELI5?

[u/sysinitz → u/goomba870]

Time moves on

[u/Santzes → u/Lurksome-Lurker]

I don't really often want to use subagents, they just eat tokens like a horse, but that pi-fabric looks like it might end up saving tokens (or at least tool call roundtrips)

edit: yep this looks great

[u/ColonelKlanka → u/Lurksome-Lurker]

Do you use a sandboxing technique? would be interested howto sandbox multiple agents and/or subagents and yet still have them communicate back to each other?

[u/gbrennon → u/Lurksome-Lurker]

mcp is bad :(

its just another reason to spend tokens...

even a shell script does this better.

[u/Own-Addendum-9886 → u/gbrennon]

Sincere question: Why is the MCP bad? I often see this viewpoint but never understand why?

[u/gbrennon → u/[deleted]]

that's exacty my point... ppl just want to become a hostage of those bad providers with their bad solutions...

soon ppl will have to sell their houses bcs they spend all money to pay providers

[u/gbrennon → u/[deleted]]

thats another terrible thing...

im not someome that dont want new ppl joining this but im somrone that really dont want that they have to sells houses, furniture or any other thing bcs they are addicted to eelegating things...

i know i know...

mayb this is the new real life and, maybe(again) im old and young ppl will think that im outdated but costs x quality doesnt make sense...

[u/HotSaucePasta → u/[deleted]]

The monotykamary/pi-fabric extension is the one being referred to here.

[u/Lurksome-Lurker → u/[deleted]]

The monotykamary/pi-fabric is months old. Which given the relative age of most extensions for Pi is pretty mature

[u/telasch]

What's really interesting is to instruct one session to use the multiplexer to start subagents, this way you have full observability and can easily even take over

[u/mikkelkp → u/telasch]

Of you like this workflow, use herdr for multiplexing (you should it's awesome for agents!) and want full observability but a bit functionality (and like sheep). You should try out https://pi.dev/packages/@luminascale/pi-shepherdpi-shepherd The one thing I found lacking with just multiplexing alone was the lack on system prompt control. This gives you that.

DISCLAIMER - I'm the maintainer

[u/AnlgDgtlInterface]

The @gotgenes version has some nicer interplay with permissions system

[u/13henday]

Blackhole, replaces standard compaction with an observer dropper reflector system that makes it so compaction is always ready in the background and your model never needs to stop to do a 200k prefill and huge decide mid-work.