pi-delegate

Pi Delegate

When to Use

• You want to delegate a bounded coding task to a separate pi implementer (Pi) and then review its diff yourself.
• The user explicitly asked for delegation to this implementer.

You are the orchestrator. Delegate a bounded coding task to a separate implementer - the Pi coding agent CLI - then review what it produced and land it yourself. You write the brief and own the judgment; the implementer makes changes in its own session; you verify and commit.

The loop needs only a shell command and file access, so any comparable orchestrator can drive it.

When NOT to use this

• The task is small enough to do inline; delegation overhead is not worth it.
• The pi CLI is not installed or authenticated.
• You need a sandboxed implementer. Pi has no sandbox and no permission modes; --read-only

restricts the tool surface, but a write-capable run executes without prompts.

Prerequisites (check once)

1. Install pi with npm install -g @earendil-works/pi-coding-agent.
2. Authenticate: /login inside pi for a subscription provider, or an API-key environment

variable / pi's auth file for an API-key provider.

3. Confirm pi --version succeeds.
4. Work in, or point --cd at, the target git repository.

Choose the model (optional)

Omit --model to use pi's configured default. To pick another, choose from pi --list-models and