mrkeyoor.com_
Mon 26 Oct 19:44 UTC
LLM Toolsevaluationupdated 26 Oct 2026

pi-subagents review

pi-subagents is an extension that lets the Pi coding agent delegate work to child sessions. It separates tasks such as code review and codebase scouting, and can run children in the foreground or in a detached background runner.

Verdict

pi-subagents installed in 6 seconds in our sandbox, but its test command timed out at 900 seconds without a final suite result. Existing Pi users have a concrete reason to try its separate reviewer and scout sessions, provided they check child completion on their actual host. For Rex supervisor workflows or experimental standalone platforms, verify the complete round trip before assigning work that cannot afford to stall.

We ran it

Lab card: what happened when we ran pi-subagentsScreenshot of pi-subagents (github.com/nicobailon/pi-subagents)
Install✓ · 6s138 packages · 226 MB
Buildn/ano build script
Tests✗ timed out · 900sran, no count parsed
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo859 files~264,378 lines of source · 15.3 MB · 2 CI workflows · tests dir

Answers from our run

Does pi-subagents build from source?

Dependencies installed in 6 seconds (138 packages), and the project has no separate build step. We cloned commit d9c5ca2 into a clean Debian container with 3 CPUs and no project-specific setup.

Do pi-subagents's tests pass?

We could not finish them: the suite was still running after 15 minutes in our container.

Does pi-subagents have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use pi-subagents?

Users expecting our lab to establish a passing full suite: the test command timed out after 900 seconds.

What are the alternatives to pi-subagents?

OpenCode, Claude Code. pi-subagents installed in 6 seconds in our sandbox, but its test command timed out at 900 seconds without a final suite result.

SetupN/ANot assessed: the package installed, but a supported Pi host with provider authentication and working child delegation was not verified.
DocsN/ANot scored: the README and standalone support guide were read, but their operating instructions were not verified on the supported host matrix.
CommunityN/ANot scored: same-day push and issue activity were inspected, without assessing support responsiveness or maintainer capacity.
MaturityN/ANot scored: the test command timed out and no complete model-backed delegation lifecycle was established by the supplied run.

Who it’s for

Pi users who want a separate reviewer or scout without moving to another coding host.
Developers willing to inspect child transcripts and confirm that results return to the parent.
Workflow authors who can check the supported host route before using background execution.

Who it’s NOT for

Users expecting our lab to establish a passing full suite: the test command timed out after 900 seconds.
Teams requiring fully validated standalone Windows support: the standalone guide calls Windows experimental.
Rex users who need verified supervisor reply delivery before adoption: issue 3079 reports a child remaining blocked after a reply, and we have not reproduced or cleared that report.
Users expecting research roles to browse after installing this extension alone: researcher and evidence-auditor require pi-web-access in the child.

Setup reality

Our October 26, 2026 run at d9c5ca2 installed in 6 seconds, recorded 138 dependencies and used 226 MB on disk. There was no build script or target. The test command timed out at 900 seconds, and npm audit reported 0 known vulnerabilities. The visible test tail shows a passing maintenance-lifecycle suite, not a final full-suite result.

The README requires Pi 1.2.0 or newer and documents installation through Pi. You need a working host and model-provider configuration. The research roles separately require pi-web-access in the child. Provider authentication and successful model-backed delegation were not established by our run.

Background execution differs between npm Pi and standalone Pi. The standalone guide fully validates official Pi 1.2.0 on Linux x64 and calls Windows experimental. Our sandbox configuration was 3 CPUs, 8 GB RAM and image lab-node:22, without raw runtime-version evidence.

Installing pi-subagents took 6 seconds in our sandbox. Getting a finished test result was another matter: the command reached our 900-second timeout without a final suite result. For an extension that coordinates other agents, that leaves a consequential question unanswered: does work reliably finish and return control on the host you intend to use?

pi-subagents adds child sessions to the Pi coding agent. You can ask a reviewer to inspect a diff or a scout to trace an unfamiliar codebase, then bring their findings back into the parent conversation. The reason to consider it is the separation of those jobs. Our run does not establish that several agents produce better code than one.

Child sessions can continue after the parent gets control back

The README distinguishes foreground sessions inside the parent Pi process from background sessions in a detached runner. Foreground work streams into the conversation. Background work keeps running after control returns, with a FleetView and inspector for checking transcripts, steering a child or stopping a run.

That makes the extension relevant when waiting for a review would otherwise occupy your coding session. It also makes result delivery part of the product's value. A child that produces a useful answer but leaves the parent waiting still needs operator attention. We did not measure that workflow in a model-backed session, so the documented inspector is a capability to evaluate rather than evidence of reliability.

The built-in roles have useful boundaries. Reviewer is documented as read-only, while worker edits files and validates its work. Oracle challenges a plan without editing. Researcher and evidence-auditor require pi-web-access in the child. Installing this extension alone therefore does not establish that its research roles have working web access.

What happened when we ran it

Our October 26, 2026 sandbox run installed pi-subagents at commit d9c5ca2 in 6 seconds, recording 138 dependencies and a 226 MB installed footprint. The checkout was 15.3 MB, with 859 files and approximately 264,378 source lines. No build script or target was available, so the build step was skipped.

The test command timed out after 900 seconds. Its supplied tail shows the extension maintenance lifecycle suite passing, including a check that starts session-owned maintenance and cleans it at shutdown. There is no final result for the entire command in that tail. We cannot turn its last visible success into a passing full suite, assign an overall passing-test count or identify what kept the command alive.

The npm audit reported 0 known vulnerabilities. That result describes this dependency scan, without proving that permission handling, child coordination or model-driven edits are safe. The recorded signals include two CI workflow files and a tests directory, with no Dockerfile. Those files show that checks exist, while our timed-out command leaves their complete result unresolved.

The configuration specifies 3 CPUs, 8 GB RAM and image lab-node:22. It does not establish the actual Node or operating-system version. Our measurements also provide no model-call cost, task completion benchmark or comparison with a single agent. The small installed footprint is useful setup evidence for this checkout, not a budget for the work its children might do.

Standalone support has a specific host boundary

pi-subagents requires Pi 1.2.0 or newer. The README says npm Pi uses a detached Node runner, while the official Pi 1.2.0 Linux x64 standalone release uses Pi's embedded SDK. Those are distinct host routes, so knowing only which extension package you installed is insufficient to establish background compatibility.

The standalone documentation names official Pi 1.2.0 on Linux x64 as its fully validated standalone target. It calls Windows experimental and places other versions, systems, architectures and packagers outside that fully validated target. That is a reason to avoid treating a successful npm install as proof of support for an arbitrary standalone Pi executable.

You also need a working model-provider configuration in Pi. This is an extension to an existing agent host, so readers choosing their first coding assistant should compare hosts before choosing this orchestration layer. Our lab did not establish provider authentication, model availability or successful child requests.

A current Rex report warrants a targeted check

Issue 3079, updated October 26, reports a native Pi child starting in a local Rex tab but remaining blocked after its supervisor replies. The reporter names pi-subagents 0.83.0 and describes concatenated bridge commands. This concerns placed-child reply delivery, rather than a generic complaint about agent output quality.

The report is not our reproduction, and it does not explain our test timeout. Its practical implication is narrower: if your intended workflow uses Rex and supervisor questions, check a complete question-and-reply round trip before delegating a job that must wait for a decision. The repository's last push was October 26, and the same day's issue activity shows ongoing work and fresh reports. Calling the project abandoned would ignore both.

OpenCode and Claude Code are host alternatives

OpenCode includes build and plan agents plus a general subagent. Evaluate it when you are selecting a coding host and want those documented roles in that host. It is a different adoption path from adding an extension to an established Pi session, and we have no comparative speed or quality measurements.

Claude Code is a coding agent for terminal and IDE workflows. Its README also documents plugins with custom commands and agents. Consider it if that host fits your existing tools. If you already use Pi, start smaller: ask one read-only child for a bounded review, inspect its result and confirm that stopping or completing it returns control as expected.

Alternatives

ProjectWhat it isPick it when
OpenCode gh↗A coding host with build and plan agents plus a general subagent.Evaluate OpenCode when choosing the coding host itself and its documented built-in agent roles fit your work.
Claude Code gh↗A coding agent for terminal and IDE workflows with documented plugins.Evaluate Claude Code when you want that coding host and its plugin system instead of extending an existing Pi setup.

What people are saying

  1. [github-trending] nicobailon/pi-subagents

Sources

  1. pi-subagents README
  2. Standalone background support
  3. Rex supervisor reply report
  4. Repository facts
  5. OpenCode README
  6. Claude Code README

More llm tools reviews

kimi-code · RAG-Anything · uzu · dsh-im · smg · dsh-context · the whole board →