These answers describe pi-subagentura v4.2.1. The released README and telemetry contract are the primary references.
What is pi-subagentura?
pi-subagentura is an open-source extension for the Pi coding agent. It provides in-process delegation, attachable child Pi sessions, progress and result tools, and reusable workflows. You supply your specialist prompts and choose models configured in Pi.
Can subagents run in-process without tmux?
Yes. The subagent_with_context and subagent_isolated tools run inside the parent Pi runtime, with inherited or fresh conversation context. They do not open attachable terminals. Interactive child sessions run as separate Pi processes and require tmux, Zellij, or Herdr.
Can I keep my own agent prompts and models?
Yes. Ask the parent to read a selected specialist prompt and pass it as the child's persona. Use --append-system-prompt for your coordination instructions, supplied as text or a file. A prompt folder is not imported automatically. The extension uses your configured Pi models and provider authentication.
Do I have to use Orchestratorv2?
No. Direct delegation works without an orchestration flag. --orchestratorv2 adds optional system-prompt guidance for routing work to attachable specialists. --orchestrator is the workflow-oriented mode. These prompts guide the model; they do not enforce a tool permission or approval boundary.
What survives a Pi restart or reload?
Standalone interactive children and their artifact-backed state can be recovered when continuing the matching parent session after reload, resume, or quit. A fresh new or fork transition cleans up owned interactive work. In-process jobs and background workflows are parent-session scoped and are retired during session replacement.
Does a separate child session isolate Git changes?
No. A separate Pi process does not automatically create a Git worktree. Choose a separate checkout or worktree and pass its working directory when agents need independent files. In-process execution and the workflow VM are not security sandboxes.
Is pi-subagentura free, and what does it send?
The extension is MIT licensed and free to install. Model usage is billed by your configured provider. Anonymous product telemetry is enabled by default; launch with --no-subagentura-telemetry to opt out. The repository's telemetry documentation defines the collected fields and other opt-out settings.
Try it with a focused task.
Start with the installation guide, then follow the parallel code review walkthrough. Still evaluating options? Read the source-linked comparison of eight Pi extensions.