pi-spawn

ProOrchestrationFSL-1.1-ALv2

Run background workers from Pi without losing your terminal. Agents, servers, builds, scripts - anything that needs a PTY and should not block your session. No tmux.

Capabilities

Spawn Pi agents or arbitrary processes in interactive PTY sessions.
Wait for results inline, or run in the background and attach later.
Send follow-ups, interrupts, or queued messages to running workers.
Parallel agents - issue several spawn_worker calls and they run concurrently.
Inspect and attach to any live worker from another terminal.

Requirements

holdpty v0.4.0 or newer (npm install -g holdpty).

worker orchestration demo showing workflow with numerous workers.

Installation Instructions

Install the whole bundle

npx --yes @bastilleworks/bastille-install bastilleworks-pro-<version>.tgz

Or install this module only

npx --yes @bastilleworks/bastille-install bastilleworks-pi-spawn-<version>.tgz

The installer fetches @bastilleworks/shared from public npm automatically. Replace <version> with the version you downloaded.

Usage Instructions

Pi command

/workers

Pi command

/inspect <id>

Pi command

/worker-logs <id>

Tools exposed to the agent: spawn_worker, send_to_worker, get_worker_message, list_workers, list_agents, get_worker_result, kill_worker, compact_worker. Reusable agent configs live in ~/.pi/agent/agents/.

Uninstall

Uninstall this extension

pi uninstall npm:@bastilleworks/pi-spawn

Or uninstall the entire bundle

npx --yes @bastilleworks/bastille-install uninstall bastilleworks-pro-<version>.tgz

Notes

Requires a valid Polar license.

All modules