pi-rex-subagents

Subagents for pi, each a pi process in a minimized floating Rex pane in the parent's window. The parent rex waits on the pane in the background and posts the child's last assistant message back as a new turn.

Tools: subagent, subagent_message, subagent_wait, subagent_list. Child sessions live under ~/.pi/agent/subagents/<parent-session-id>/.

• subagent with fork: true starts the child from a copy of the parent's active branch; the task is its next message.
• subagent_message reaches a running child as a steering message, over a Unix socket in the temp directory (PI_SUBAGENT_SOCKET).
• A result counts as delivered once it is in the parent's transcript. One that Escape or quitting pi dropped from the queue is added back without starting a turn.

Requires pi started in a Rex terminal (REX_SESSION set) with rex on PATH; subagent fails outside Rex.

Agents

Agent definitions are .md files with frontmatter, read from this package's agents/ (none ship), then from directories other extensions register on globalThis[Symbol.for("rex-subagents.agentDirs")], then overridden by name from ~/.pi/agent/agents/.

Install

git clone ssh://git@10.9.0.1:2222/ricardsmf/pi-rex-subagents.git ~/projects/pi-rex-subagents
pi install ~/projects/pi-rex-subagents

pi loads a local package in place: edits apply on /reload.

Test

npm test

The tests load the extension through the installed pi's own runtime (PI_PACKAGE_DIR overrides).