About this template
Pi + Minimal Subagents (scout · researcher · worker)
Pi with a real multi-agent workflow pre-wired: a single subagent tool with three tuned agents, running as isolated parallel Pi processes.
| Agent | Tools | Model | Purpose |
|---|---|---|---|
| scout | read, grep, find, ls | claude-haiku-4-5 | Fast codebase recon |
| researcher | web_search, web_fetch | claude-sonnet-4-6 | Web research |
| worker | read, write, edit, safe_bash, web tools, subagent | claude-sonnet-4-6 | Code changes — can dispatch scout/researcher to protect its own context |
The chain is depth-capped by design: worker may only spawn scout and researcher, never another worker. Fan out by asking for multiple subagents in one turn — Pi runs them in parallel (default cap 4) with a live per-agent tool log and token gauge. Press ctrl+o to toggle the expanded view.
Includes the web-search + web-fetch extensions (hard dependencies of researcher/worker) with web-fetch's npm toolchain pre-installed, and the safe_bash tool (blocklisted shell) for worker.
Try this first
Dispatch scout to map this repo and researcher to find the latest release notes for X — in parallel — then have worker write SUMMARY.md combining both.
Setup (BYOK)
Open the terminal and export your keys before launching pi:
export ANTHROPIC_API_KEY=sk-ant-... # required — all three agents run Claude models
export GOOGLE_SEARCH_API_KEY=... # optional — enables web_search (researcher/worker)
export GOOGLE_CSE_ID=... # pairs with the key above
pi
Without the Google pair, scout and worker's file tools work fully; researcher will report missing credentials on first use. Get Google Custom Search credentials at https://developers.google.com/custom-search/v1/introduction.
Keep keys in the environment. Do not create ~/.pi/agent/extensions/web-search/auth.json — files in the extensions directory ride any template snapshot you capture from this VM; environment variables never do.
Credits
Built on amosblomqvist/pi-subagents with the web tools from amosblomqvist/pi-config, running on Pi by Mario Zechner.