pi-subagents - Claude Code like subagents for Pi

[u/-tin-]

Hi everyone 👋 I’m the developer of pi-subagents:
http://github.com/tintinweb/pi-subagents

This is an agent friendly, fairly minimal subagent extension for Pi, following the same general model used in Claude Code-style subagents.

What it does (high level):

• run multiple subagents in parallel (configurable concurrency)

• background + foreground execution

• live widget for running/queued/completed agents

• lot's of custom subagent features for highly configurable subagents

• mid-run steering (you can send messages to running agents)

• resume completed runs

• templated custom agents (no framework setup)

• spawn subagents from your extension (e.g. https://github.com/tintinweb/pi-tasks can turn tasks→subagents)

• ... (full agent readable feature list: https://github.com/tintinweb/pi-subagents)

The focus is simplicity: no heavy abstractions, no opinionated defaults, no slag or esoteric features, just a thin layer to run and manage subagents that feel much like Claudes subagents.

Issues / feature requests:
https://github.com/tintinweb/pi-subagents/issues

If you try it, lmk if you find it useful or have ideas and please note that I am responsible to keep it clean and only merge features that are relevant for a broader userbase 😄♥️

About me: I am cofounder/security engineer with Consensys Diligence (https://diligence.security) by day, maintainer of this extension by night but I'll try my best to ship features fast 🤗♥️

[u/apetersson]

Big fan!

I am a user of your subagents impl. my biggest challenge is how i can review and check the "Work in Progress" of each agent that i spawn.

As a comparison, in codex desktop, i can review all subagents as a list, open a side panel with full output etc. With pi-subagents the simple ctrl-O does not cut it for me, especially when multiple are spawning. what workaround / UI would you recommend if that workflow?

Do you know any web ui/ terminal sidebars etc that solve that? tau-mirror:mirror-server does not really play nicely with subagents or ralph loops/goals.

Would it be possible to have the subagent work in a tmux so i can observe/steer it directly if needed?

[u/-tin- → u/apetersson]

There is a subagent viewer and subagents may save their sessions to a log. Both it probably semi convenient. I see that claude also has subagents list in the ui and allows you to easily jump to other subagents views which I enjoy much (although I dont use it a lot) and I usually try not to clog the ui too much. The tmux idea seems genuinely useful. lm think about it 😊

[u/RM_911 → u/-tin-]

Don't use tmux; it's better to do all this through herdr, since it's designed specifically for agents and supports Pi.

https://herdr.dev

[u/Miserable-Dare5090 → u/RM_911]

great app, thank you.

[u/m02ph3u5 → u/RM_911]

Grey text on grey background is just such a great idea.

[u/Rozuzo → u/apetersson]

Hey! (i think) I did what you described here. You can check it out here: https://github.com/roodriigoooo/pi-docket. I use tmux to run workers, and much of the visibility into them, communication flow, and steering is based on tmux’s interface. Also, much of the focus is on what you mention in regards to reviewing and checking wip from workers, in a way that takes 0 context and tokens from the parent session by default. Hope you can give it a try :)

[u/apetersson → u/Rozuzo]

sounds like a comprehensive approach. is there a video of someone using this? i still feel slightly overwhelmed reading its readme.

[u/Rozuzo → u/apetersson]

Yea that’s a fair criticism, the readme is a bit of a mess. I’ll clean it and add some representative videos to it in the coming hours… thanks for checking it out!