@alexeiled/pi-subagents-bridge

Protocol adapter that lets @tintinweb/pi-tasks TaskExecute spawn nicobailon/pi-subagents.

Packages

Package details

extension

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

npm repo home report

$ pi install npm:@alexeiled/pi-subagents-bridge

Package: @alexeiled/pi-subagents-bridge
Version: 0.1.4
Published: Jul 9, 2026
Downloads: not available
Author: alexeiled
License: MIT
Types: extension
Size: 22.4 KB
Dependencies: 0 dependencies · 1 peer

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ],
  "image": "https://raw.githubusercontent.com/alexei-led/pi-subagents-bridge/main/assets/bridge.svg"
}

Security note

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

README

pi-subagents-bridge

Bridge for @tintinweb/pi-tasks TaskExecute → nicobailon/pi-subagents.

pi-tasks speaks v2 RPC. pi-subagents speaks v1. This extension answers the ping handshake as v2, forwards spawn/stop to pi-subagents, and turns subagent:async-complete back into subagents:completed / subagents:failed.

Install

pi install npm:@alexeiled/pi-subagents-bridge

Needs @tintinweb/pi-tasks and nicobailon/pi-subagents already installed.

Use

TaskCreate(..., agentType="general-purpose", ...)
TaskExecute(task_ids=["1"])

agentType mapping:

general-purpose → delegate
Explore / explore → scout
anything else passes through unchanged

Use an execution-capable agent type for execution tasks. Read-only agents such as reviewer are fine for read-only tasks, but they will not run builds, tests, or other commands just because the task prompt asks them to.

Behavior

tracks only run IDs spawned through this bridge
ignores unrelated pi-subagents runs
keeps completion text from async-complete payloads
disables pi-subagents acceptance gates for TaskExecute runs
disables pi-subagents live control nudges for TaskExecute runs
stop is best-effort cancel

Details

docs/protocol-research.md — upstream protocol facts
docs/design.md — bridge flow and maintenance rules

Constraint

Do not load @tintinweb/pi-subagents at the same time.