pi-delegate

1# Pi Delegate
2 
3You are the **orchestrator**. Delegate a bounded coding task to a separate **implementer** - the Pi
4coding agent CLI - then review what it produced and land it yourself. You write the brief and own
5the judgment; the implementer makes changes in its own session; you verify and commit.
6 
7The loop needs only a shell command and file access, so any comparable orchestrator can drive it.
8 
9## When NOT to use this
10 
11- The task is small enough to do inline; delegation overhead is not worth it.
12- The `pi` CLI is not installed or authenticated.
13- You need a sandboxed implementer. Pi has no sandbox and no permission modes; `--read-only`
14  restricts the tool surface, but a write-capable run executes without prompts.
15 
16## Prerequisites (check once)
17 
181. Install pi with `npm install -g @earendil-works/pi-coding-agent`.
192. Authenticate: `/login` inside pi for a subscription provider, or an API-key environment
20   variable / `pi`'s auth file for an API-key provider.
213. Confirm `pi --version` succeeds.
224. Work in, or point `--cd` at, the target git repository.
23 
24## Choose the model (optional)
25 
26Omit `--model` to use pi's configured default. To pick another, choose from `pi --list-models`
27and pass an explicit id or pattern like `<provider>/<model-id>` or `sonnet:high`. The relay
28accepts letters, digits, and `. _ : / -` only (the value reaches a shell on Windows), so glob
29patterns with `*` are not forwarded.
30 
31## The loop
32…