Skip to content

Orchestration / Pro

pi-spawn

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.

ProFSL-1.1-ALv2Pi extensionInstallation ↓

What it does.

  • 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.

Before you install.

  • holdpty v0.4.0 or newer (npm install -g holdpty).
workersRecorded view
worker orchestration demo showing workflow with numerous workers.

pi-spawn, no tmux, only PTY

Put it to work.

Use the Pro archive from your purchase. The Pro or Team bundle includes its Pi extensions. An individual module archive uses the same installer.

Only the filename is used. The file stays on your device and is never uploaded.

Choose a file to build your exact command.

Run this command from the folder containing the archive. Selecting a file here does not install or execute anything.

Activate your license with /bastille-license refresh inside Pi. Activation and periodic entitlement validation contact Polar. Your workload is not uploaded to Bastille-C3.

Full installation & activation guide →

In use.

Inside Pi

/workers

Reference syntax · replace arguments

/inspect <id>

Reference syntax · replace arguments

/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/.

Worth knowing.

  • Requires a valid Polar license.
Remove this module

Uninstall this extension

pi uninstall npm:@bastilleworks/pi-spawn

Removing an extension does not cancel your subscription. Manage renewal separately.

← Back to every module