# Pi Minimal Subagents

> Pi with a depth-capped multi-agent rig: scout (fast recon), researcher (web research), worker (code changes) — parallel fan-out, live inline rendering, zero setup.

- Agent: Pi
- Plan: Starter (1 vCPU, 2 GiB RAM, 10 GiB disk)
- Forks: 0 · Stars: 0
- Creator: https://www.jurniti.com/creator-ca0ff2
- Tags: multi-agent, parallel-agents, pi, subagents

**To fork:** open https://www.jurniti.com/templates/pi-minimal-subagents and use the Fork action — it starts a Stripe Checkout for a new VM seeded with this template's persist disk (same flat plan price, no fork fee).

## README

# 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`:

```bash
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](https://github.com/amosblomqvist/pi-subagents) with the web tools from [amosblomqvist/pi-config](https://github.com/amosblomqvist/pi-config), running on [Pi](https://github.com/badlogic/pi-mono) by Mario Zechner.