@ineersa/my-pi-subagents

Subagent orchestration extension for Pi coding agent — single and parallel foreground execution, agent discovery, skill injection, model fallback

Packages

Package details

extension

Install @ineersa/my-pi-subagents from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@ineersa/my-pi-subagents
Package
@ineersa/my-pi-subagents
Version
0.1.0
Published
May 12, 2026
Downloads
72/mo · 72/wk
Author
ineersa
License
MIT
Types
extension
Size
152.2 KB
Dependencies
0 dependencies · 5 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@ineersa/my-pi-subagents

Subagent orchestration for Pi coding agent. Single & parallel foreground execution · agent discovery · skill injection · model fallback · recursion guard.

npm license

Origin

This package is a full rewrite based on pi-subagents by Nico Bailon. The original concept, agent-discovery patterns, and skill-injection design informed this implementation. See LICENSE for copyright details.

What's included

  • Single foreground subagent runs — delegate a task to a named agent
  • Parallel foreground runs — fan out tasks across agents with concurrency control
  • Agent discovery — auto-discover agents from ~/.agents, ~/.pi/agent/agents, .pi/agents, .agents
  • Skill injection — inject skills into subagent sessions
  • Model fallback — configurable fallback when the requested model is unavailable
  • Recursion guard — prevents runaway subagent nesting
  • Artifact & session capture — capture subagent output for downstream use

Install

# via the my-pi installer
npx @ineersa/my-pi --yes

# or directly with pi
pi install @ineersa/my-pi-subagents

Tool

Registers one tool: subagent

Supported modes:

  • single: { agent, task }
  • parallel: { tasks: [{ agent, task, count? }, ...], concurrency? }

Optional controls: context, cwd, agentScope, artifacts, includeProgress, share, sessionDir, output, skill, model

Config

~/.pi/agent/extensions/subagent/config.json

Supported keys:

  • defaultSessionDir
  • maxSubagentDepth
  • parallel.maxTasks
  • parallel.concurrency

Docs