tintinweb/pi-subagents

Claude Code like Sub-Agents & Workflow Orchestration for Pi — parallel execution, live widget, fleet view, custom agent types, mid-run steering, claude compatible dynamic workflows and more ...

What it solves

pi-subagents is an extension for the pi platform that enables the creation and orchestration of autonomous sub-agents. It allows users to move beyond a single-model conversation by spawning specialized agents that can run in the background, work in parallel, or follow deterministic scripted workflows, reducing the cognitive load on the main agent and improving the efficiency of complex tasks.

How it works

The project implements a system where a parent agent can spawn child agents using an Agent tool. These sub-agents can be configured with their own system prompts, models, and tool restrictions. The extension provides several orchestration methods:

  • Autonomous Spawning: Agents can be run in the background (asynchronous) or foreground (blocking).
  • Scripted Workflows: A SubagentWorkflow tool allows for deterministic JavaScript scripts to orchestrate multiple agents using patterns like parallel(), pipeline(), and phase().
  • Agent Mentions: Users can interact with agents directly via @handle syntax at the prompt, allowing them to steer, resume, or start agents without adding turns to the main conversation.
  • Isolation: Agents can run in isolated Git worktrees to ensure changes are committed to branches upon completion.

Who it’s for

Developers using the pi platform who need to manage complex, multi-step AI agent workflows, specifically those who want a "Claude Code-style" experience with autonomous sub-agents and background task management.

Highlights

  • Claude Code-style UI: Includes a persistent widget for active agents, a "FleetView" for navigating running sub-agents, and a live conversation viewer.
  • Parallel Execution: Supports concurrent background agents with configurable concurrency limits and smart group notifications.
  • Nested Sub-agents: Allows agents to spawn their own children (opt-in) with depth-capped delegation.
  • Deterministic Workflows: Supports JavaScript-based orchestration scripts that are compatible with Claude Code's Workflow tool.
  • Scheduling: Ability to register agents to fire based on cron expressions, intervals, or one-shot timestamps.
  • Cross-extension RPC: An event bus enabling other pi extensions to spawn, stop, and join sub-agents.

Related

  • Project
    ogulcancelik/pi-extensions

    A collection of extensions for the pi terminal-based coding agent that adds features like session recall, context compaction, and subagent management.

  • Project
    narumiruna/pi-extensions

    A collection of extensions and libraries for the Pi Coding Agent that adds advanced coding tools, workflow automation, and observability features.

  • Project
    nicobailon/pi-intercom

    Pi‑intercom is a Pi‑extension that adds a local broker and a `/intercom` UI/tool, letting multiple Pi AI‑agent sessions on the same machine send, ask, reply, hand‑off, and cancel messages one‑to‑one. It supports aliases, blocking asks, safety knobs, and integrates with pi‑subagents for supervisor escalation, enabling coordinated multi‑agent workflows like planner‑worker delegation.

  • Project
    The-AI-Republic/pi-dash

    An AI agent orchestration platform for asynchronous coding, allowing developers to define tasks and let background agents handle the implementation.

  • Project
    nicobailon/pi-subagents

    pi‑subagents is a Pi AI‑assistant extension that lets the main Pi session spawn focused child agents (scout, reviewer, worker, oracle, etc.) to handle tasks like code review, research, implementation, and auditing. Subagents can run in the foreground (streaming live) or in the background (detached process). Users simply install the package (`pi install npm:pi-subagents`) and then ask Pi in plain language (e.g., “Use reviewer to review this diff”). The system orchestrates the child agents, provides observability via a FleetView panel, and offers configuration options such as tool activation and spawn limits.