copilot-delegate

1# Copilot Delegate
2 
3You are the **orchestrator**. Delegate a bounded coding task to a separate **implementer** — the
4GitHub Copilot 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 in a clean working tree; you verify
6and commit.
7 
8The loop needs only a shell command and file access, so any comparable orchestrator can drive it.
9 
10## When NOT to use this
11 
12- The task is small enough to do inline; delegation overhead is not worth it.
13- The `copilot` CLI is not installed or authenticated.
14- You need a hard sandbox. Copilot exposes sandbox controls, but they are upstream-experimental
15  (MXC-based, controlled via the `/sandbox` command and settings, disabled by default) — this relay
16  does not configure them. `--read-only` only disables edit tools (`--mode plan`); shell commands
17  still run. If project files must not change at all, dispatch against a clean or isolated worktree.
18 
19## Prerequisites (check once)
20 
211. Install `copilot` (`npm install -g @github/copilot`; the CLI requires Node 22+, the relay
22   itself runs on Node 18+ — the relay probes `copilot version`).
232. Authenticate: run `copilot login` (interactive web/device flow), or set
24   `COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN` in the environment.
253. Confirm `copilot version` succeeds.
264. Work in, or point `--cd` at, the target git repository.
27 
28## Choose the model (optional)
29…